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COURSE DESCRIPTION 
F01 Multics Concepts and Utilization 

Duration: Five Days 

Intended For: Personnel requiring capability to use the Multics 

sys^enis 

Course Synopsis: This course presents the basic information needed 

to use the Multics system, including discussions 
and examples of: the typing conventions used for 
Multics terminals; a Multics text editor; 
commands used to write, compile and execute 
programs; utility command which provide of the 
user environment, manipulation of files, and 
inter-user communication; and the types of errors 
which can occur, with procedures for recovery. A 
general overview of Multics hardware and soft^dte 
facilities is also presented. 

Interactive workshops are included to reinforce 
the material presented. 

Objectives: Upon completion of this course, the student should 

be able to: 

1. Login to and logout from the Multics system. 

2. Create and edit files In the storage system 
with the qedx text editor. 

3. Compile, run, and debug simple programs, and 
manipulate the run-time environment. 

4. Use other system commands to manipulate files, 
tailor the user environment, and communicate 
with other users. 

Prerequisite: Programming Logic and Flowcharting (G024) or 

previous data processing experience. 
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STUDENT BACKGROUND 
Multics Concepts and Utilization (FOI) 



NAME: ^ 

TITLE: 

COMPANY ADDRESS: 



MANAGER: 



_PHONE: 



OFFICE PHONE 



INSTRUCTOR'S NAME: y^///^/ Cff/ff//i/ 



1. 



r. 'z :p=:rtSS":i=;.*i.%\,ir-.'» '!:•„-«"• "—p"- 



Do you meet the prerequisiti 

of the student text? If yes, check "a""or "b" 

If no, check »»c" or »'d". =* or d . 

a [ J Prerequisite satisfied by attending 
"Course Description". 



course indicated in 



b [ ] Meet prerequisite by equivalent 



experience (explain briefly) 



c [ ] Elected or instructed to attend course anyway, 
d [ ] Was not aware of prerequisite. 

'■ and\njfFff?.f jr^o^MblT'^' '^^^ you attended? Furnish d 



ates 



(PLEASE TURN OVER) 



IX 



FOI 



STUDENT BACKGROUND 



3. 



5. 



Check the boxes for which you have an^ related experience. (May 
be other than Honeywell's) 



[ ] PL1 [ ] COBOL 

[ ] JCL [ ] OPERATIONS 

r 1 OTHER COMPUTER RELATED 



[ ] FORTRAN 
[ 3 GCOS 



[ ] ASSEMBLY 
[ ] MULTICS 



^. Detail any Multics experience you have had: 



Objectives for attending this course (May check more than one). 
] Require information to provide support for a Multics system 
] To maintain an awareness of this product 
] To evaluate or compare its potentials 
] Required to use or implement 
] Need update from a previous release 
] Require a refresher 
] Other: _«__ 
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TOPIC I 
MULTICS OVERVIEW 



Page 

Some Basic Terminology 1-1 

Development History 1~5 

Multics Design Goals and Results 1-9 

Administration ........... 1-15 
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SOME BASIC TERMINOLOGY 



• HARDWARE 



REFERS TO THE PHYSICAL COMPONENTS OF A COMPUTER- FSPFfTAT r y rn 
THE ELECTRONIC CIRCUITRY ^UM^UltH, ESPECIALLY TO 



MAJOR COMPONENTS: CENTRAL PROCESSOR UNIT (CPU) MAIN MFMORy 
DISK DRIVES, TAPE UNITS, PRINTER, CARD READER cIrDpSnch'' 



• SOFTWARE 



EXEc5te'Sn'?L HArK^ '''''''''' '°''' °« INS^'^CTIONS THAT 



EXAMPLES: A FORTRAN PROGRAM, THE PL/I COMPILER THF nflT/i race- 
MANAGER, THE OPERATING SYSTEM ^^Mi^iLER, THE DATA BASE 
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SOME BASIC TERMINOLOGY 



SYSTEM RESOURCES 



11 CENTRAL PROCESSOR / CPU (TIME OCCUPIED) 



MAIN MEMORY / PRIMARY MEMORY / CORE (AMOUNT OCCUPIED » TIME 
OCCUPIED) 



D PERIPHERAL DEVICES 

D DISK DRIVES (AMOUNT OF DATA TRANSFERRED) 

D TAPE DRIVES (AMOUNT OF DATA TRANSFERRED) 

D CARD PUNCH (AMOUNT OF DATA PUNCHED) 

D PRINTER (AMOUNT OF DATA PRINTED) 

fl TERMINALS (CONNECT TIME & AMOUNT OF DATA TRANSFERRED) 

D MEDIA 

D DISK PACKS / SECONDARY MEMORY (AMOUNT OF DATA STORED) 

TAPES (NUMBER USED) 

fl CARDS (NUMBER PUNCHED) 

B PRINTER PAPER (AMOUNT USED) 

Q SYSTEM AND SITE PROVIDED SOFTWARE (RENTAL) 

1-2 F01 



SOME BASIC TERMINOLOGY 



• BIT 



S THE MOST FUNDAMENTAL UNIT OF INFORMATION 



D A BIT IS EITHER ON OR OFF (1 OR 0) 



• BYTE 



A SMALL UNIT FOR MEASURING THE AMOUNT OF MEMORY THF ST7R nw a 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 



ON MOST LARGE SCALE HONEYWELL EQUIPMENT, A BYTE EQUALS 9 BITS 



fl ON MULTICS, ONE ASCII CHARACTER OCCUPIES ONE BYTE 



WORD 



PROGMM^fpnT^^fr^^^^S^ ^"^ ^^^"NT 0^ MEMORY, THE SIZE OF A 
PROGRAM OR FILE, OR THE SPACE ON A TAPE OR DISK PACK 



OR S^BITf^^ ^^^^^ HONEYWELL EQUIPMENT, ^WORD EQUALS 4 BYTES 
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SOME BASIC TERMINOLOGY 



• USER 



a ONE WHO USES THE COMPUTER FACILITY 



• PROJECT 



B A SET OF USERS GROUPED TOGETHER FOR ACCOUNTING AND ACouSS 
PURPOSES 



A PROJECT IS OFTEN A GROUP OF USERS WORKING TOWARDS A COMMON 
GOAL 



D USERS ON A PROJECT OFTEN WORK FOR THE SAME DEPARTMENT OR UNIT 
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DEVELOPMENT HISTORY 



MULTICS 



MULTIPLEXED INFORMATION AND COMPUTING SERVICE 



• 1960-1963: CTSS DEVELOPMENT 



FIRST LARGE-SCALE TIME-SHARING SYSTEM 



D EXPERIENCED GAINED WAS USED LATER IN THE MULTICS PROJECT 
1 CTSS WAS USED TO DEVELOP MULTICS SOFTWARE 



• 1964: INITIAL SPECIFICATIONS FOR MULTICS 
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DEVELOPMENT HISTORY 



• 1964-1965: INITIAL MULTICS DEVELOPMENT WAS A JOINT EFFORT BY: 

D MASSACHUSETTS INSTITUTE OF TECHNOLOGY (PROJECT MAC) 
I OVERALL PROJECT CO-ORDINATION 
D OPERATING SYSTEM 
fl SELECTION AND DESIGN MODIFICATIONS OF THE HARDWARE (GE 63^ 

fl BELL TELEPHONE LABORATORIES 
fl COMPILERS AND ASSEMBLER 
D FILE SYSTEM 

D GENERAL ELECTRIC COMPUTER DIVISION (HONEYWELL) 
HARDWARE MODIFICATION 



1965: FALL JOINT COMPUTER CONFERENCE 



D PRIMARY TECHNICAL PAPERS PRESENTED 
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DEVELOPMENT HISTORY 



1967: GE 645 HARDWARE AVAILABLE (MODIFIED GE 635) 



1967: SOFTWARE DEVELOPMENT UNDERWAY 



1968: AVAILABLE TO SYSTEM PROGRAMMERS 



1969: AVAILABLE FOR USE AT MIT 



1971: PROJECT MAC FUNDING STOPPED. HIS ADOPTS 



• 1972: 6180 HARDWARE AVAILABLE 



D BULK STORE REPLACED DRUM 



a EXTENDED INSTRUCTION SET (EIS) 



D RING MECHANISM MOVED TO HARDWARE 
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DEVELOPMENT HISTORY 



1973: ANNOUNCED AS A »»STANDARD*' HIS PRODUCT 



• 197M: LEVEL 68 HARDWARE 



e 68/60 MOS MEMORY 



D 68/80 MOS MEMORY AND CACHE STORE 



• 1975: COBOL-74 



1975: SORT/MERGE 



• 1976: MULTICS DATA BASE MANAGER (MDBM) 



1977: WORD PROCESSING SYSTEM (WORDPRO) 



1-8 F01 



MUtliCS DESIGN GOALS AND RESULTS 



REMOTE TERMINAL ACCESS AS NORMAL USAGE MODE 

2 ALL SYSTEM RESOURCES AVAILABLE VIA TERMINALS 

II USAGE OF CARDS IS MINIMAL 

fl INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 
INTER-USER COMMUNICATION 



CONTINUOUS/UTILITY GRADE OPERATION 

B EXTREMELY STABLE OPERATING SYSTEM 
fl MODULAR DESIGN 
fl WRITTEN IN PL/I 

ON LINE METERING. ACCOUNTING. BILLING AND SOFTWARE INSTALLATION 
fl OPERATORS REQUIRED: ONE 
fl UNATTENDED OPERATION MODE 
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MULTICS DESIGN GOALS AND RESULTS 



ABILITY TO GROW AND CONTRACT WITHOUT SYSTEM OR USER REORGANIZATION 



D SYSTEM SIZE - TRANSPARENT TO USERS, PROGRAMS, AND OPERATING 
SYSTEM 



CHANGES TO SYSTEM SIZE ARE MADE WITHOUT REGENERATING THE 
OPERATING SYSTEM OR USER PROGRAMS 



DYNAMIC RECONFIGURATION - TRANSPARENT TO USERS AND PROGRA?^!: 



DECENTRALIZATION OF THE SYSTEM'S ADMINISTRATION 

fl HIERARCHY OF ADMINISTRATORS: 
D THE SYSTEM ADMINISTRATOR 
D PROJECT ADMINISTRATORS 
i USERS 
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mvncs DESIGK GOALS AND RESULTS 



DECENTRALIZATION OF THE SYSTEM'S LOGICAL FILE SPACE 

fl HIERARCHY OF DIRECTORIES* 
I ROOT DIRECTORY 
fl SYSTEM DIRECTORIES 
D PROJECT DIRECTORIES 
11 USER DIRECTORIES 



• RELIABLE FILE SYSTEM 

fl INCREMENTAL BACKUP SYSTEM (Backup SysDaemon) 
AUTOMATED RETRIEVAL 
D SALVAGE SUBSYSTEM 
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RULTiCS DESIGH GOALS AND RESULTS 



• ACCESS CONTROLS THAT ALLOW SELECTIVE SHARING OF INFORMATION AND 
SERVICES 



i MULTICS IS THE MOST SECURE COMMERCIAL OPERATING SYSTEM 
AVAILABLE 



D USER AUTHENTICATION (BY PASSWORD) 



D ACCESS CONTROL LIST - ACL (BY NAME AND PROJECT) 



n tir.r.V9,9. T<^nT ATTHM MRTH&MTQM _ STM ^ nv QCPIIDTTV t ct/ct amh Mcrn Tn 

KNOW) 



D RING STRUCTURE (8 LEVEL MASTER/SLAVE HIERARCHY) 



• SERVES BOTH LARGE AND SMALL USERS EFFICIENTLY 



D RESOURCES ARE AUTOMATICALLY ALLOCATED ON DEMAND - WHEN NEEDED, 
AND IN PROPORTION TO THE SIZE OF THE TASK 
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^tlL^iCS DESIGN GOALS AND RESULTS 



• COMBINE SYSTEM FLEXIBILITY WITH EASE OF USE 
U VIRTUAL MEMORY 

II ONLY ONE STORAGE SYSTEM FOR BOTH USERS AND OPERATING SYSTEM 
D ASCII CHARACTER SET USED THROUGHOUT 
i INTERACTIVE AND BATCH ENVIRONMENTS ARE COMPATIBLE 

fl EXEMPLARY COMMAND LANGUAGE (NO JCL!) 

D COMMAND NAMES 

i FULL NAME (DESCRIPTIVE) 
fl SHORT NAME (CONVENIENT) 

D CONTROL ARGUMENTS WITH INTELLIGENT DEFAULTS 

fl ACTIVE FUNCTIONS 

I STAR AND EQUAL CONVENTION 

B ABBREV PROCESSOR 

fl EXEC^COMS (COMMAND FILES) 
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MULTiCS DESIGN GOALS AND RESULTS 



• DIFFERENT ENVIRONMENTS AND HUMAN INTERFACES WITHIN A SINGLE SYSTEM 
D STANDARD SERVICE (FULL MULTICS) 
SUBSYSTEM (E.G. FAST, BASIC, APL) 
fl LIMITED SERVICE 
D TAILORED ENVIRONMENT 



EVOLUTIONARY DESIGN ABLE TO INCORPORATE TECHNOLOGICAL IMPROVEMENTS 
AND TO MEET GROWING USER EXPECTATIONS 



D MODULAR DESIGN 



II GENERAL (NOT SPECIFIC) SOLUTIONS 



fl COMPATIBLE EXPANSIONS 
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ADMINISTRATION 



• THE EFFECTIVE ADMINISTRATION OF A LARGE COMPUTER INSTALLATION CAN 
BE A DIFFICULT JOB 



• npniTP^TnT^^^' ^ HIERARCHY OF ADMINISTRATORS HAS BEEN DEFINED L 



ORDER TO: 



D DECENTRALIZE CONTROL OF SYSTEM RESOURCES BY nT<;TRTRnTTMr 
AUTHORITY AND RESPONSIBILITY TO LOWER LEVELS DISTRIBUTING 



THE MULTICS ADMINISTRATION HIERARCHY CONSIST OF THREE LEVELS: 



D SYSTEM ADMINISTRATORd) 

fl PHYSICAL, ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE 
ibxoTEM 



i PROJECT ADMINISTRAT0R(2) 

fl ADMINISTRATIVE AND FINANCIAL CONCERNS OF THE PROJECT 

a USER 

fl CONTROL AND USAGE OF RESOURCES ALLOCATED TO HIM/HER 



(1) Related Multics Course: System Administration (F60) 

(2) Related Multics Course: Project Administration (F61) 
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ADMINISTRATION 



SYSTEM 
ADMINISTRATOR 



ProjA PROJECT 
ADMINISTRATOR 




F01 PROJECT 
ADMINISTRATOR 























USER 
S_01 




USER 
S_02 




USER 
S_03 


USER 
S_04 
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ADMINISTRATION 



the system administrator 

° (metering' and'tuning) ^^''^^^"''ation and operating parameters 

" ?RoS ^'''*^'^' *"" ai-locates resources to the system 

D administers the SYSTEM'S SECURITY NEEDS 

1 REGISTERS USERS AND ASSIGNS INITIAL (AND NEW) PASSWORDS 

fl MAINTAINS RECORDS OF SYSTEM USAGE 

D SETS RESOURCE USAGE PRICES AND DETERMINES BILLING CYCLE 

° RESOURCeI USE^ "'"^ °^ '"*''°'' ^° ''''°^^'' T"^ =°ST OF SYSTEM 

° iSuPTIOnV's^SvICe'°'' ''''^^ ''°'' TERMINAL AND WITHOUT 
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ADMINISTRATION 



THE PROJECT ADMINISTRATOR 

D DISTRIBUTES RESOURCES AND ATTRIBUTES ALLOCATED TO PROJECT 

HAS ACCESS TO THE PROJECT'S RESOURCE USAGE AND ACCOUNTING DATA 

1 ADDS AND DELETES REGISTERED (AND ANONYMOUS) USERS TO PROJECT 
D DEFINES THE ENVIRONMENT AND SETS RESOURCE LIMITS FOR USERS 

D SETS ACCESS ON USERS' HOME DIRECTORY 



THE USER 



fl HAS CONTROL OVER RESOURCES ALLOCATED TO HIM 



D HAS ACCESS TO HIS OWN RESOURCE USAGE AND ACCOUNTING DATA 



D MAY SELECTIVELY SHARE HIS PROGRAMS AND DATA WITH OTHER USERS 



II MAY CHANGE HIS PASSWORD 
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TOPIC II 
HOW TO ACCESS MULTICS 



Page 

Remote Terminal Access .... 2-1 

User Registration and Identification . 2-2 

Characteristics of Terminals 2-4 

Access Sequence 2-5 

login and logout Commands 2-6 

Typing Conventions 2-9 

Some Simple Commands 2-11 
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REMOTE TERMINAL ACCESS 



• REMOTE TERMINAL ACCESS IS THE NORMAL MODE OF ACCESS 



• ALL SYSTEM RESOURCES ARE ACCESSIBLE VIA REMOTE TERMINAL 



• USES STANDARD TELEPHONE LINES 



• "LOGGING IN" REFERS TO THE PROCESS OF 



1 TELEPHONING THE MULTICS SYSTEM 



i CONNECTING THE TELEPHONE TO THE TERMINAL 



i WAITING FOR MULTICS TO SEND YOU A GREETING 



D IDENTIFYING YOURSELF TO THE SYSTEM 
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USER REGISTRATION AND IDENTIFICATION 



NEW USERS ARE REGISTERED BY THE SITE SYSTEM ADMINISTRATOR 



• ADMINISTRATOR A5;5^Tnw?^ il P»»o-id«f iA a lutrnnt* n. >.-. _• ^ «vtn 

PASSWORD ~ _ ' " 

Person id's Project id's PASSWORD'S 

TSmith ProjA ts 

Greenberg ProjA $$$! 

Student_04 F01 atlanta 



A USER MAY BELONG TO MORE THAN ONE PROJECT - HOWEVER, ONE PROJECT 
IS ALWAYS DESIGNATED AS THE USER'S "DEFAULT PROJECT" 



THE USER'S PASSWORD IS ASSOCIATED WITH HIS Person id ONLY 



• User id 



REFERS TO THE Person__id . Project_id PAIR 
TSmith. ProjA 
SWebber.Doc 66 
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USER REGISTFtATION AND IDENTIFICATION 



THE USER'S PASSWORD IS REQUIRED IN ORDER TO AUTHENTICATE THE USE 
OF THE USER'S Person id 



• THE USER'S Person__id AND Project id ARE THE KEYS THAT DETERMINE 
WHAT INFORMATION AND SERVICES Hi: IS AUTHORIZED TO ACCESS AND 
CONTROL 



Password 



AUTHORIZES 
USE OF 




AUTHORIZES 
USE OF 



DESIGNATED FILES 
AND SERVICES 



2-3 



F01 



CHARACTERISTICS OF TERMINALS 



TERMINALS BEHAVE LIKE ELECTRIC TYPEWRITERS 



• MANY HAVE SEPARATE "CARRIAGE RETURN" AND "LINE FEED" KEYS 



CONCEPTUALLY, THE "LINE FEED" KEY SENDS THE TYPED LINE 



DUPLEX: HALFJl^^^ MODE: LINE 
CASE: LOWER RATE: 30 

PARITY: EVEN 



• TERMINAL TO COMPUTER COUPLINGS: 

1 HARDWIRED (A PERMANENT WIRE CONNECTS TERMINAL TO COMPUTER) 

D TELEPHONE-MODEM (TELEPHONE LINE CONNECTS TERMINAL TO COMPUTER) 
B ACOUSTIC (PROXIMITY) 
D DIRECT (PUSH A BUTTON) 
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ACCESS SEQUENCE 



PLUG-IN AND TURN ON THE TERMINAL 



SET THE TERMINAL SWITCHES 



• IF HARDWIRED TERMINAL 



B IDENTIFY YOURSELF VIA THE login COMMAND 



• IF TELEPHONE-MODEM TERMINAL 



DIAL THE APPROPRIATE NUMBER AND WAIT FOR HIGH-PITCHED TONE 



e CONNECT THE PHONE TO THE COUPLER DEVICE 



fl WAIT FOR MULTICS TO RESPOND WITH A MESSAGE SIMILAR TO: 

Multics MR6.0: Honeywell LISD Phoenix, System M 
Load = 51.0 out of 95.0 units: users = 51 

IDENTIFY YOURSELF VIA T^E login /OMMAND 
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LOGIN AHD logout COMMANDS 



• login, 1 



D A COMMAND USED TO GAIN ACCESS TO MULTICS 



fl INITIATES A PROGRAM CALLED THE USER'S PROCESS 



USAGE: login Person__id {Project_id} 

1 TSmith 

1 TSmith FED 

1 Student 07 F01 



IF A Project_id IS NOT SPECIFIED THE USER'S DEFAULT Project id 
IS ASSUMED 



RESULTS: THE USER WILL BE ASKED TO SUPPLY THE PASSWORD 
ASSOCIATED WITH HIS Person id 



A PASSWORD MASK WILL BE GENERATED -OR- PRINTING OF THE 
PASSWORD WILL BE INHIBITED 



SUPPLYING THE CORRECT PASSWORD COMPLETES THE USER'S LOG IN 
SEQUENCE 



THE Project_id USED AT LOG IN DETERMINES WHO RECEIVES THE BILL 
FOR THE CURRENT TERMINAL SESSION 



THE Person id AND Project id USED AT LOG IN DETERMINES WHERE IN 
THE MULTICS VIRTUAL MEMORY THE USER "FINDS" HIMSELF 
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LOGIN AND LOGOUT COMMANDS 



<DIAL TELEPHONE NUMBER> 
^ <CONNECT TERMINAL/TELEPHONE> 
<WAIT FOR LOGIN HERALD> 

1^^ YJ Vin\t^,Q^z MR6.0: Honeywell LISD Phoenix, System M 
'^ ^ Load = 51.0 out of 95.0 units: users = 51 

1 TSmith 
Password 
EEfiBKEBBEEHH 

TSmith ProjA logged in 06/28/77 1553.2 mst Tue from terminal "2^3" 
Last login 06/28/77 1^25.8 mst Tue from terminal "013" 
A new PL/1 compiler was installed; type help new pll. 
Type help sked for hours of operation FW31 ~ 
r 1553.5 1.314 1.332 30 




READY MESSAGE 



A MESSAGE THAT IS PRINTED EACH TIME THE USER IS AT "COMMAND 
LEVEL" 



D THE READY MESSAGE REPORTS 
D THE TIME OF DAY 

THE NUMBER OF CPU SECONDS USED SINCE THE LAST READY MESSAGE 
D THE NUMBER OF MEMORY UNITS USED SINCE THE LAST READY MESSAGE 

THE NUMBER OF PAGES (1024 WORDS) BROUGHT INTO MEMORY FOR THE 
USER SINCE THE LAST READY MESSAGE 
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LOGIN AND LOGOUT COMMANDS 



logout 



D INFORMS MULTICS THAT THE USER IS THROUGH WITH THE CURRENT 
TERMINAL SESSION 



D USAGE: logout 



D RESULTS: THE USER WILL BE DISCONNECTED FROM MULTICS 



logout 

TSmith ProjA logged out 06/28/77 1749.^ mst Tue 

CPU usage 17 sec, memory usage 103.1 units 

hangup 



new^proc 



DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 



D EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 



OFTEN USED "WHEN ALL ELSE FAILS*' OR TO RESET THE USER'S 
ENVIRONMENT 



USAGE: new proc 
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TYPING CONVENTIONS 



# (NUMBER SIGN) 

D USED TO "ERASE" THE PREVIOUS CHARACTER 

login TSM#mith 
login TSMith####mith 
logen##in TSme#ith 
logim T###n TSrnith 



ERASE CHArIcTER^^^ ^^ COUNTED AS ONE CHARACTER WHEN USING THE 



• § (AT SIGN) 



D USED TO "KILL" THE CURRENT LINE 



login TSMith@login TSrnith 

logen@login TSme#ith 

logen##im#n Tsm##Sme@login TSrnith 
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TYPING CONVENTIONS 



• \ (BACKSLASH) 



fl THE CHARACTER \ IS A FRONT-END PROCESSOR ESCAPE SEQUENCE THAT 
CAUSES CERTAIN CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A 
LITERAL 



OFTEN USED TO SUPPRESS (ESCAPE) THE SPECIAL MEANING OF //, @, 
linefeed AND OTHER SPECIAL CHARACTERS 



sm TSmtth.ProjA I need a \#8 tin can. 

sm TSmith.ProjA He»s selling 3 \§ $4.50 each. 



• COMMAND LINE FLOW 



TYPED LINE 



i 



i 



I 



(AT THE TERMINAL) 



FRONT-END PROCESSOR (# AND § EDITING AND LINE DISCIPLINE) 



COMMAND PROCESSOR (INTERPRETS THE TYPED LINE) 



EXECUTION 
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SOME SIMPLE COMMANDS 



who 



LISTS THE NAMES AND PROJECTS OF ALL USERS CURRENTLY LOGGED IN 



D USAGE: who {args} {-control__args} 

who y ^yy^a^r-^ y^^^ii?'--^^ 



who -name 

who -long 

who TSmith 

who .ProjA 

who May .F01 .ProjA 







• how_many_users, hmu 

TELLS HOW MANY USERS ARE CURRENTLY LOGGED IN 

fl USAGE: how_raany__users {args} {-control_args} 
hmu 

hmu -long 
hmu TSmith 
hmu .ProjA 
hmu May .F01 .ProjA 
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SOME SIMPLE COMMANDS 



help (YA WANT IT, WE GOT IT) 

I PROVIDES INFORMATION ABOUT THE MULTICS SYSTEM AND ITS COMMANDS 

I USAGE: help {name} 

help who 

help sked 

help help 



ANSWER: ves. no. rest. sH n aani-A^n .»♦-►, «,v«-.-.u «» -r> 



list, Is (ROLL CALL) 



fl RETURNS INFORMATION ABOUT THE USERS SEGMENTS (FILES) 



USAGE: list 
Is 
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SOME SIMPLE COMMAHDS 



accept^messages, am (I'M LISTENING) 



ii ENABLES THE USER TO RECEIVE MESSAGES AT HIS TERMINAL 



^ 2IvfSr^?S^ M?Mf f ^^ ^^^b ^2 J^ ^"^ "S^^'S MAILBOX (A SEGMENT 
HAVING THE NAME Person id.mbx) 



D CREATES A PERMANENT MAILBOX FOR THE USER IF NONE EXISTS 

I USAGE: accept_messages 
am 



• send_message, sm 

fl SENDS MESSAGES TO A GIVEN USER ON A GIVEN PROJECT 

1 MESSAGES ARE EITHER: 

I PRINTED ON THE RECIPIENT'S TERMINAL, OR 

14 * ^Aw^i^ a.1, *ii£, ncvyxr xCiit A O riAlLiDUA 

I USAGE: send__message Person__id.Project_id message 

sm TSmith.ProjA When are you going to lunch? 

sm Greenberg.FED May I have access to your file? 
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SOME SIMPLE COMMANDS 



print_messages, pm 

fl PRINTS ALL MESSAGES STORED IN THE USER»S MAILBOX 

D MESSAGES ARE DELETED FROM THE MAILBOX WHEN PRINTED 

fl USAGE: pr internes sages 
pm 



defer_messages, dm (I'M BUSY... NO DISTRACTIONS WANTED) 

fl REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 

fl ELIMINATES UNWANTED INTERRUPTIONS 

D THIS IS THE DEFAULT UPON LOGIN 

D "UNDONE" BY THE accept_message COMMAND 

fl USAGE: defer_messages 
dm 
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SOME SIMPLE COMMANDS 



YOU ARE NOW READY FOR WORKSHOP 
#1 
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TOPIC III 
QEDX BASICS 



Page 

What is qedx 3-1 

qedx Concepts 3-2 

Basic qedx Requests 3-5 

Basic qedx Examples * 3-8 
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MAT IS QEDX 



• Qedx, qx 



ONE OF SEVERAL TEXT EDITORS AVAILABLE ON MULTICS USED TO 

MODIFY THE CONTENTS OF EXISTING ASCII SEGMENTS 

D CREATE (INPUT) THE CONTENTS OF DESIRED ASCII SEGMENTS 



REQUe'sT™ *'"'" '"' ''^' ^' EN^E«ED BY COMMAND . AND 



exitp:d by 



Q USAGE: qedx 

qx 



COMMAND LINE FLOW 

TYPED LINE 



I 



FRONT-END PROCESSOR 



I 

JBS 

1 



qedx SUBSYSTEM 



EXECUTION 
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QEDX CONCEPTS 



USER INVOKES THE EDITOR BY TYPING qedx OR qx 



THERE ARE TWO PRINCIPAL MODES OF OPERATION WITHIN qedx 

EDIT MODE 

fl THE INITIAL (DEFAULT) MODE WHEN ENTERING qedx 



THE USER READS THE CONTENTS OF AN EXISTING SEGMENT INTO A 
BUFFER (A SCRATCH PAD) 



THE USER THEN PERFORMS EDITING FUNCTIONS ON THE CONTENTS OF 
THE BUFFER BY TYPING EDIT REQUESTS: 

D LOCATING 

D SUBSTITUTING • 

fl DELETING 

D PRINTING 



THE USER THEN WRITES (SAVES) THE EDITED VERSION OF THE 
SEGMENT BACK TO THE SAME (OR A NEW) SEGMENT 



D INPUT MODE 

B THE USER ENTERS THE INPUT MODE (FROM THE EDIT MODE) BY 
TYPING ONE OF THREE INPUT REQUESTS 

a ALL SUBSEQUENT TEXT FROM THE TERMINAL (EXCEPT ESCAPE 
^F5UENCES) IS APPENDED TO THE USER'S BUFFER (A SCRATCH PAD) 

1 "\f" IS AN ESCAPE SEQUENCE THAT RETURNS THE USER TO THE EDIl 

MUL'L 
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QEDX CONCEPTS 



oS:!:,,,.^-^^^^ ■^^ ^ ^®^^ BUFFER ARE GIVEN IMAGINARY LINF MliMRPRc; 
STARTING WITH 1 (ONE) j-iiiiuiwani LiNt NUMBERS 



• THERE EXISTS A CONCEPTUAL POINTER TO INDICATE THE "CURRENT LINE" 



• qedx REQUESTS MAY DO ONE OR MORE OF THE FOLLOWING 
II MOVE THE CONCEPTUAL POINTER 
D PERFORM OPERATIONS ON THE CURRENT LINE 
B PERFORMS OPERATIONS ON A SET OF LINES WITH 1 (ONE) 



• ALL LINES CAN BE ADDRESSED BY SUPPLYING THEIR LINE NUMRFR 
NO LINE NUMBER IMPLIES "CURRENT LINE" NUMBER 

P (PRINT CURRENT LINE) 

5P (PRINT THE FIFTH LINE) 

^ Qn /r\r»T rirrtr% 



-f 1 -^ 



\.vE.i-r.TE LINES 3 THROUGH 9) 
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QEDX CONCEPTS 



THE ADDITION AND DELETION OF LINES AFFECT THE IMAGINARY LINE 
NUMBERS IMMEDIATELY 



• AFTER EACH qedx REQUEST, THE "CURRENT LINE" GENERALLY BECOMES THE 
LAST LINE ADDRESSED 



FOR CONVENIENCE, THE LAST LINE CAN ALSO BE ADDRESSED BY UST^' . KE 
SYMBOL $ (DOLLAR SIGN) 
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BASIC QEDX REQUESTS 



EDIT REQUESTS DESCRIPTION 

^ P^^^ READ: READ CONTENTS OF THE SEGMENT 

SPECIFIED BY path AND APPEND AFT^'R tup 
SPECIFIED LINE ($ ASSUMED) 

P PRINT: PRINT THE SPECIFIED LINE(S) ON THE 

TERMINAL 



LINE NUMBER: PRINT LINE NUMBER OF SPECIFIED 
LINE 



d DELETE: DELETE SPECIFIED LINE(S) ^miA THE 

BUFFER 

/xxx/ LOCATE: LOCATE AND PRINT THE NEXT LINE 

CONTAINING THE xxx CHARACTER STRING. WRAP 
AROUND IF NECESSARY 

s/existing/new/ SUBSTITUTE: SUBSTITUTE EVERY OCCURRENCE OF 

THE EXISTING STRING WITH THE NEW CHARACTER 
STRING IN SPECIFIED LINE(S) 

^ P^^^ WRITE: WRITE THE SPECIFIED LINE(S) OF THE 

BUFFER INTO SEGMENT HAVING THE NAME path 
(ENTIRE BUFFER IS THE DEFAULT) 

e command_line EXECUTE: PASS THE REMAINDER OF THE REQUEST 

LINE TO THE MULTICS COMMAND PROCESSOR FOR 
EXECUTION 

Q QUIT: EXIT FROM THE EDITOR 
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BASIC QEDX REQUESTS 



INPUT REQUESTS 



DESCRIPTION 

APPEND: ENTER INPUT MODE AND APPEND THE 

LINE(S) TYPED AT THE TERMINAL AFTER THE 

SPECIFIED LINE 



INSERT: ENTER INPUT MODE AND INSERT THE 
LINE(S) TYPED AT THE TERMINAL BEFORE THE 
SPECIFIED LINE 



CHANGE: ENTER INPUT MODE AND REPLACE THE 
SPECIFIED LINE(S) WITH THE LINE(S) TYPEP AT 
THE TERMINAL 




ylj:,^ ^r.J^. (^^^^-i'^ 
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BASIC QEDX REOUEStS 



^ 

• ADDRESSING SYNTAX ^ . >^ , . ^ ^'2^i;C 

I qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS: 

B <request> - GENERALLY APPLIED TO THE CURRENT LINE 



r temp.pll (^(APPENDS TO END OF BUFFERl 

P 

s/old/new/ 

d 



w add.pll (MWRITES THE ENTIRE BUFFER) 

B ADR<request> - APPLIED TO THE LINE ADDRESSED 

6r >udd>FED>Kerr>terap.pl1 

5p 

7s/old/new/ 

9d 

3w add.pH 

D ADR,ADR<request> - APPLIED TO THE _RANGE OF LINES ADDRESSED 

5,15s/old/new/ 

9,12d 

1 ,20w add.pll 
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BASIC QEDX EXAMPLES 



RESULTING BUFFER 



qedx 

a 

"Now is hte time 

for al good 

lir county 
\f/ a 




"Now 
for a 
their 


is hte t 
1 good 
county 


ime 



1,$p 

"Now is hte time 
for al good 
their county 
2d 

— «- 

for al good 

s/al/all/ 

$s/ty/try."/ 

P 

their country." 

w Henry. quote 



RFFilll.TTNr, RlfFFFR 



"Now is hte time 
for all good 
their country." 



RESULTING BUFFER 



/good/ 

for all good 

a 

men to come 

to hte aid of 

1 ,$p 

\f 



"Now 


is hte time 


for a 


11 good 


men t 


o come 


to ht 


e aid of 


1,$p 




their 


country." 
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BASIC QEDX EXAMPLES 



HESULTING BUFFER 



P 

1,$p 

d 

1,$s/hte/the/ 

w Henry, quote 



"Now is the time 


1 


for all good 


2 


men to come 


S 


to the aid of 


4 


their country." 


5 



1,$d 
a 

\f 



-Patrick Henry 



RESULTING BUFFER 




RESULTING BUFFER 



^T Henry. quote 

P 

their country." 

a 

\f 
1i 
FAMOUS QUOTE: 



\f 

w Henry. quote 



FAMOUS QUOTE: 




"Now is the t: 


Lme 


for all good 




men to come 




to the aid of 




their country. 


ti 


-Patrick 


Henry 


■ 





1 

2 

3 
4 

5 
6 
7 
8 
9 
10 



YOU ARE NOW READY FOR WORKSHOP 
#2 
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TOPIC IV 
MORE QEDX 



Page 

qedx Terminology il_-j 

Special Symbols . **.*.*.*.'.*!!!.' i|I> 

Examples ••••.•..*.....!!!]!!['** hI^ 

Addressing , . [ . 4I7 

Additional Buffers ...*!!.'! n'q 

Areas for Additional Study ...!!!!!.*!!''** i|IlO 
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QEDX TERMINOLOGY 



REGULAR EXPRESSION:.^ 



11 ANY NUMBER OF CHARACTERS (INCLUDING NONE) DELIMITED RY fl rtpht 
SLANT AND OBEYING A CERTAIN SYNTAX l^tLIMITED BY A RIGHT 

/abc/ /a.c/ 

/olcl/ /old.»$/ 

/calendar/ /'^calendar/ 



SEARCH EXPRESSION: 



A REGULAR EXPRESSION IMMEDIATELY FOLLOWING A oedx rfomr<^t 
(/abc/ IN THESE EXAMPLES) ruL.L.uwiwu a qedx REQUEST 



EXAMPLES) 
s/abc/xyz/ 
1,25s/abc// 
/abc/ 



REPLACE EXPRESSION: 



^ TM^.f ^S!!Sp?"^?^^T^« STRING IN A SUBSTITUTE REQUEST. (/abc/ IN 



s/old/abc/ 
1,5s/old/abc/ 
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SPECIAL SYMBOLS 



/ (RIGHT SLANT -OR- SLASH) 



DELIMITS A REGULAR EXPRESSION 
/abc/ 

/''character/ 
/ters.*$/ 




USAGE n AS PART OF AN ADDRESS IN A qedx REQUEST 



D ADDRESSES THE CURRENT LINE 
1,.cl 



^N^D USAGE 2?) AS A CHARACTER IN A SEARCH EXPRESSI 

MATCHES ANY CHARACTER 

/a.c/ MATCHES: aac 

abc 
azc 
a c 
. . .etc 



ON 
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SP£CIAL SYMBOLS 




HAS SPECIAL MEANING ONLY IN A SEARCH EXPRESSION 



MEANS ANY NUMBER ai^g^gMNljON£) OF THE PRECEDING CHARACTER 

/ab»c/ MATCHES: ac 

abc 
abbe 
abbbc 
. . .etc 



/a,.*c/ MATCHES: 



ac 
axe 
axyzc 
. • .etc 




USAGE 1j^ AS PART OF AN ADDRESS IN A qedx REQUEST 

J ADDRESSES THE LAST LINE OF THE USER'S BUFFER 

1,$p 
$d 



USAGEjy AS THE LAST CHARACTER OF A SEARCH EXPRESSION 

/calendar$/ MATCHES: calendar 
IF "calendar" ENDS A LINE 
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SPECIAL SYMBOLS 




" SvL.^^^^^^^ MEANING ONLY AS THE FIRST CHARACTER OF A SEARCH 
EXPRESSION 



D MATCHES THE BEGINNING OF A LINE (I.E. AN IMAGINARY CHARACTER 
PRECEDING THE FIRST CHARACTER ON A LINE) 



/"calendar/ MATCHES: calendar 
IF "calendar" BEGINS A LINE 




° sSLTimE^REQUEsf ''^ ^^^^ ^^ ^"^ ^^^^^^^ EXPRESSION OF A 



^ nvnLooxL REPLACED BY THE STRING WHICH MATCHED THE REGULAR 
EXPRESSION IN THE SEARCH EXPRESSION 



s/camp/&ing/ SAME AS: s/camp/camping/ 
s/junk/"&"/ SAME AS: s/junk/" junk"/ 



s/ab/&&&/ 



SAME AS: s/ab/ababab/ 



s/a.c/&def/ SAME AS: 



s/aac/aacdef/ 
s/abc/abcdef/ 
s/azc/azcdef/ 
s/a c/a cdef/ 
. . .etc 
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SPECIAL SYMBOLS 



// (DOUBLE RIGHT SLANT - OR - SLASH SLASH) 



USAGE ip AS THE REPLACE EXPRESSION OF A SUBSTITUTE REQUEST 

THE REPLACE EXPRESSION IS THE NULL STRING (A MEANS OF 
DELETING EXISTING CHARACTER STRINGS) 

s/abc// 




USAGE 2:\AS A SEARCH EXPRESSION 



D qedx REMEMBERS THE LAST SEARCH EXPRESSION DEFINED BY THE 
USER 



e // STANDS FOR THE LAST SEARCH EXPRESSION DEFINED 



/a.c/ 

s//xyz/ 

// 



SAME AS 



/a 


c/ 




s/a.c/xyz/ 




/a. 


c/ 





\c (LEFT SLANT C -OR- BACKSLASH C) 




ChLac^FR^^Sat^^ot T^Lt r^^tl .ESCAPE SEQUENCE THAT CAUSES THE 
CHARACTER THAT FOLLOWS TO BE INTERPRETED AS A LITERAL 



^VMPnff ^^ (ESCAPES) THE SPECIAL MEANING OF qedx SPECIAL 



SYMBOLS 

/a\c.b/ 

s/\e"echpplex/ "echoplex/ 
s/abe/\c&def/ 
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EXAMPl^ES 



INTERPRET THE FOLLOWING qedx REQUESTS 
1 ,$s/a. . .b// 

1 -Jfes/fl h/JLX./ 

1 ,$s/a.»b/xyz/ 
1 ,$s/a. .*b/xyz/ 
1 ,$s/a.\c.«b/xyz/ 
1 ,$s/a. .\c»b/xyz/. 
1,$s/"a.. .b// 

1 ^e y^ » Wd> / / 

% ^ yftgt t» * * t Unp / f 

1,$s/./a/ 

1,$s/./4&/ 

1,$s/.»/&&/ 

1 ,$s/'*a«b»c»cl/abcd/ 

1 ,$s/"a.»b.»c.»d/abccl/ 

1,$s/^ »// 

1,$s/'^ »/ ■&/ 

1, $3/'^. $/&&&/ 
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ADDRESSING 



qedx REQUEST MAY TAKE ONE OF THREE GENERAL FORMS 

ADR<request> 

D ADR,ADR<request> 



• ADDRESSES MAY TAKE ONE OF THREE GENERAL FORMS 

D ABSOLUTE LINE NUMBERS 
5d 
$p 

10,12s/abc/xyz/ 
3 

I RELATIVE LINE NUMBERS (RELATIVE TO "CURRENT LINE") 
.+4d 
+4d 
-2,.p 
-2,+5s/abc/xyz/ 

-2 



4-7 

^ ' F01 



ADDltESSXHG 



D CONTEXTUAL ADDRESSING 

1 AN ADDRESS MAY BE A REGULAR EXPRESSION 

D A LINE CAN BE ADDRESSED BY MATCHING REGULAR EXPRESSIONS TO 
STRINGS IN THE LINE 

/abc/d 
/abc/,25p 
/abc/+2,25p 
/abc/+2,+25p 

-4,/x.2/p 

/"ab»c/+2,/x.2/-3s/boat /boating / 
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ADDITION Al BUFFERS 



• THE USER'S INITIAL BUFFER (SCRATCH PAD) HAS A RESERVED NAME OF 
b(0) 



• USERS MAY DEFINE AN ARBITRARY NUMBER OF ADDITIONAL BUFFERS BY 
SIMPLY REFERRING TO THEM BY SOME CHOSEN NAME 



BUFFER REQUESTS 



DESCRIPTION 



m(narae) 

\b(name) 
b(narae) 



MOVE: MOVE THE SPECIFIED LINE OR LINES IN THE 
CURRENT BUFFER TO A BUFFER HAVING THE SPECIFIED 
NAME 



REPRESENTS THE CONTENTS OF THE SPECIFIED BUFFER 

MAKE THE SPECIFIED 



BUFFER: CHANGE BUFFERS. 
BUFFER THE "CURRENT" BUFFER 



STATUS: 
BUFFERS 



PRINT A SUMMARY OF THE STATUS OF ALL 



fxL^^S ^^^^^ EXAMPLE. MOVE LINES 14 THROUGH 17 IMMEDIATELY BELOW 
LINE 10 , 

14,17ni(1) 

10a 

\b(1)\f 
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AREAS FOR ADDITIONAL STUDY 



ADDITIONAL DOCUMENTATION OF qedx 



MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 



NEW USER'S GUIDE (AL40) 



fl help qedx 



iilULJI lUfiUS 



MULTIPLE REQUEST ON A LINE 
dp 

s/abc/xyz/p 
s/abc/xyz/w file__13 
\fw 
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AHEAS FOR ADDITIONAL STUDY 



ADDITIONAL qedx EDIT REQUESTS 

g (global) -cr^ ciM 



gp/xyz/ 

1,10gd/xyz/ 

10,26g=/xyz/ 

V (exclude) 

vp/xyz/ 
1,10vd/xyz/ 
1 , .v=/xyz/ 

n (nothing) 

5n 
" (comment) 

"This is a comment in a macro 
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AHEAS FOR ADDItriatlAL STUDY 



ADDRESSING USING ";" INSTEAD OF '»,« 
ADR;ADR<request> 
/abc/;+5ci 

D DELIMITERS OTHER THAN »V" 

RESERVED BUFFERS: b(0), b(exec), b(args) 

D qedx MACRO FACILITY 



1 BY TYPING THE FOLLOWING COMMAND LINE: 

qedx my_macro.qedx add 

THE FOLLOWING MACRO IS INVOKED WITH 
CONTAINING THE ARGUMENT add 



BUFFER b(args) 



my__macro.qedx 



r \b(args) .fortran 

1,$s/write.»)/print/ 

w 

q 



^♦-12 



F01 



TOPIC Y 
THE STORAGE SYSTEM 



Page 

Segments ..... c_2 

Directories ......!,*]!!'*' 5-6 

Storage System Control I ,.[,,., , ^Zq 

Storage System Hierarchy ..,,,,.,,,,' 5I10 

Pathname Conventions .*.''** 5-13 
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• SYSTEM GOALS: 

fl DECENTRALIZATION OF THE SYSTEM'S LOGICAL FILE SPACE 
i EASE OF USE 



• EFFECT ON STORAGE SYSTEM 

D HIERARCHY OF DIRECTORIES 

II PATHNAME CONVENTION 

>udd>FED>LJones> tool s>my_edi tor 

WORKING DIRECTORY CONCEPT 

change__wdir >udd>FED>LJones>tools 
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• SEGMENT 



SEGMENTS 




r.<=>!2- 



V. /i.a^yjP''^'''^^^^^ /^^'^^ ^-^s-^^?*-*"^' 



THE BASIC UNIT OF INFORMATION STORAGE 

II SOMETIMES REFERRED TO AS A FILE 

fl SEGMENTS RESIDE ON DISK PACKS (SECONDARY STORAGE) 

SIZE IS INTEGER NUMBER OF RECORDS (1024 WORDS). 0,1,2,3 

MAXIMUM SIZE IS 256 RECORDS (256K WORDS) 



ALL SEGMENTS HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME 

home_work_3 

add.pll 

start_up.ec 
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SEGMENTS 



• MUST DISTINGUISH BETWEEN THE CONTENTS OF A *^rr.MFMT awn rue- 
ATTRIBUTES OF A SEGMENT ^v.«iiL«ic> ur a bEGHENT AND THE 

I THE CONTENTS OF A SEGMENT MAY BE: 
I DATA (EITHER RAW OR FORMATTED) 
I TEXT (USUALLY ASCII) 
I SOURCE OR OBJECT PROGRAM 
I EMPTY (ZERO LENGTH) 

i SOME ATTRIBUTES OF A SEGMENT ARE: 

D THE NAME(S) OF THE SEGMENT (CALLED ENTRYNAME(S)) 

° UsL^NAME)^^ "^^^^^ IDENTIFIER (A UNIQUE, 36 BIT, INTERNALLY 

D THE AUTHOR (I.E., THE user__id OF THE CREATOR) 

THE LENGTH (IN BITS) OF THE SEGMENTS CONTENTS 

D THE BIT COUNT AUTHOR (I.E. THE user id OF THE LAST PERSON 
TO MODIFY THE CONTENTS) user___ia ur iMt LAST PERSON 

1 THE ACCESS CONTROL LIST SPECIFYING WHO MAY ACCESS THF 
SEGMENT AND HOW THEY MAY ACCESS IT "^ 

° SEGMEN^"^^ ^^ DISK SPACE (IN RECORDS) OCCUPIED BY THE 
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SEGMENTS 



D DATE AND TIME SEGMENT »S CONTENTS WERE LAST MODIFIED 

D DATE AND TIME THE SEGMENT'S ATTRIBUTES WERE LAST MODIFIED 

D DATE AND TIME SEGMENT'S CONTENTS WERE LAST DUMPED (I.E. 
COPIED TO TAPE BY THE MULTICS BACKUP PROCEDURES) 

D DATE AND TIME SEGMENT'S CONTENTS WERE LAST REFERENCED 

THE STATE OF THE SEGMENT'S COPY SWITCH 

THE STATE OF THE SEGMENT'S SAFETY SWITCH 



• THE CONTENTS OF A SEGMENT MAY BE READ BY USING THE print COMMAND 
OR qedx's "r" AND "p" REQUESTS 



THE ATTRIBUTES OF A SEGMENT MAY BE OBTAINED BY USING THE list OR 
THE status COMMAND 



THE ACCESSING OF A SEGMENT'S CONTENTS AND A SEGMENT'S ATTRIBUTES 
ARE INDEPENDENTLY CONTROLLED BY THE MULTICS ACCESS CONTROL 
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SEGMENTS 



CONTENTS 



ATTRIBUTES 



ATTRIBUTE VALUE 



The Multics System i 
s a general purpose 
computer system deve 
loped by the\012Mass 
achusetts Institute 
of Technology and H 
oneywell Infor-\012 
mation Systems. Int 
reduced to commercia 
1 markets\012in Janu 
ary 1973, Multics w 
as then the result o 
f more than 7 years 
of research. \012 



names: 

author: 

access: 

bit count: 
records used: 
date modified: 
date dumped: 
date used: 



home_work_3, hw3 
May. FED. a 

r w May. FED.* 

r w *.SysDaemon.* 

49698 

2 

03/21/77 103^.4 mst 

03/21/77 1051.0 mst 

09/07/77 0818.9 mst 



• ccL25!!(!n"^ "^^ ^^ MILLION SEGMENTS IN A SYSTEM (512 MSU * 38,000 
SEGMENTS) 



An 



R — Q^ 



—WE SEGMENTS CONTAIN THE NAMES 
ADDRESSES AND ATTRIBUTES OF OTHETsT ^^"iHin int NAMhb, 



D THESE SEGMENTS SERVE AS A CATALOG OF THE OTHER SEGMENTS 



D THESE "CATALOG" SEGMENTsXaRE CALLED DIRECTORIES> 
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DIRECTORIES 



DIRECTORY 



L»^n"^^^ CONTAINING THE NAMES, ADDRESSES AND ATTRIBUTES OF 
OTHER SEGMENTS AND/OR OTHER STORAGE SYSTEM ENTITIES 



L^nHF ^^ ORGANIZING (CATALOGING) SEGMENTS AND/OR OTHER 
STORAGE SYSTEM ENTITIES 



SPECIFICALLY, A DIRECTORY MAY BE A CATALOG OF THE FOLLOWING 
STORAGE SYSTEM ENTITIES: 

FILES 

D SEGMENTS (SINGLE SEGMENT FILES) 
D MULTISEGMENT FILES 

D OTHER DIRECTORIES 

1 LINKS 

II MAY BE EMPTY 



• ALL DIRECTORIES HAVE AT LEAST ONE GIVEN NAME (ENTRYNAME) 

F01 

Dlr_A 

system_library unbundled 
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DIRECTORIES 



seg_1 



Student 01 





Student 01 
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STORAGE SYSTEM CONTROL 



MAY HAVE UP TO 19 MILLION SEGMENTS IN A SYSTEM, SOMEONE MUST 
CONTROL: 



i THE ALLOCATION OF DISK SPACE TO USERS (WHO GETS WHAT?) 



THE CREATION AND USE OF SEGMENTS (I»VE GOT A SECRET!) 



D THE SHARING OF SEGMENTS (YOU MAY USE MINE TOO!) 



HIERARCHY OF ADMINISTRATORS 



fl THE SYSTEM ADMINISTRATOR 



fl PROJECT ADMINISTRATORS 



i USERS 
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SfORAGE SYSTEM CONTROL 



SYSTEM 
ADMINISTRATOR 



ProjA PROJECT 
ADMINISTRATOR 
























F01 PROJECT 






ADMINISTRATOR 




USi 


:r 




US! 


:r 




USI 


:r 




USER 


S__01 




S_02 




S_03 




S_04 
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STORAGE SYSTEM HIERARCHY 



NEED TO PARTITION THE FAMILIES OF DIRECTORIES AND SEGMENTS INTO 
MANAGEABLE COMMUNITIES 



• STORAGE SYSTEM IS MAPPED ONTO ADMINISTRATION HIERARCHY 



^^^^^^.-^--7 



ROOT 
DIRECTORY 



USER DIRECTORY 
DIRECTORY 




A 



Jid- 



F01 
DIRECTORY 



















May 

DIR 




Kerr 
DIR 




Abel 
DIR 




S 02 
DTR 



S 03 
DTR 



S 04 

dIr 
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STORAGE SYSTEM HIERARCHY 



THE STORAGE HIERARCHY IS ANALOGOUS IN FORM TO AN INVERTED TREE 



• mLrrnll ^^^^CTORY DIRECTORY (udd) EMANATES FROM THE ROOT 



DIRECTORY 



DIRECTOR?iSdd) ^^^^^^^^^^^ ^"^^^^^ ^^^^ ^"^ "^^^ DIRECTORY 



* SiRECTOrLs^^^^^^^^^^^ ^"^^^^^ ^^^" ^"^^^ RESPECTIVE PROJECT 



USE^ DIR^TORf ^'^^^p^^^f^^L SUBORDINATE TO THEIR OWN 

BOTTOM) - UP TO A MAXIMUM DIRECTORY DE PTH OF 16 (TOP TO 



• ^/i?n^Tn^L^"°^^ POSITION IS IMMEDIATELY BELOW A GIVEN DIRECTORY IS 



SAID TO BE: 



"In the directory" 
- OR - 
"Under the directory" 
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STORAGE SYSTEM HIERARCHY 




system_library_ 
standard 



user_dir__dir 
(udd) 



system_library_ 
unbundled 




r seg_1 J f Princej 



hw dir 



[add.pllj 
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PATHNAME CONVENTIONS 



ABSOLUTE PATHNAME 




A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRFfTORY^ ry 
ITS ABSOLUTE POSITION IN THE DIRECTORY HIERARCHY ^^^^^^^^^^ ^^ 



W??I3^?LP.nprpTnPn^^^ ^^^ DIRECTORY'S) ENTRYNAME 

WITH ALL SUPERIOR DIRECTORIES LEADING BACK TO THE ROOT 

>udcl>F01>Student_01>add.pl1 



^ ISSs^K.r,^^^^^'^^^-*^"^^) CHARACTER IS USED TO SEPARATE THE 
ENTRfSAMES IN A PATHNAME ^c^rAtiHit iHh 

a AN ABSOLUTE PATHNAME ALWAYS BEGINS WITH > (GREATER-THAN) 

B DIRECTORY ABSOLUTE PATHNAMES 
>udd>ProjA 
>udd>F01>Student_01 
>udd>F01>Student_01>hw__dir 

SEGMENT ABSOLUTE PATHNAMES 

>udd>F01>Student__01>add.pl1 

>udd>F01>Student_01>hw_dir>lesson_2 
>udd>ProjA>Kerr>start__up.ec 
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PATHNAME CONVEJITIONS 



NOTICE THAT AN ABSOLUTE PATHNAME SUCH AS 

>udd>ProjA>Kerr>start_up.ec 
IDENTIFIES? 

fl THE ENTRYNAME OF THE SEGMENT (start__up.ec) 
D THE Person^id OF THE "OWNER" (Kerr) 



THB" Pr>n 4 Artf >. ■! /4 r\V TUP linurMCDti /n^^ihS 
••••- • • 'i'^^wwv jiW wii A4i*^ \jn nun \r i \jj n J 
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PATHNAME CONVENTIONS 



_HOME DIRECTORY ( WHERE THE HEART IS) 



^ IcLo^^n^^IS^^ ^^ ""^^" ^"^ ^SER "FINDS" HIMSELF IMMEDIATELY 
Ar lEn LOG IN 



1 THE INITIAL WORKING DIRECTORY 



n?Lo$ADv"~^^ ^^^ Project__id GIVEN AT LOG IN DETERMINE THE HCHE 
DIRECTORY 



IS GENERALLY: >udd>Project_id>Person_id 
>udd>F01>Student_02 
>udd>ProjA>Abel 



WO RKING DIRECTORY (WHFRF THE ACTION IS) 



THE DIRECTORY IN WHICH THE USER IS CURRENTLY WORKING (THE 
INITIAL WORKING DIRECTORY IS THE HOME DIRECTORY) "''"^'''^ ^^"^ 



ISLn^Hn!!^^ ^^^^^^ HIS WORKING DIRECTORY, AS DESIRED, TO ANY 
OTHER DIRECTORY IN THE STORAGE SYSTEM ^ , i^ hjmi 



D COMMANDS SUCH AS list AND qedx»s "r" and "w" WILL OPERATF ON 
THE SEGMENTS IN THE USER^S WORKING DIRECTORY 
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PATHNAME COHVENTIOHS 



RELATIVE PATHNAME 



A PATHNAME THAT UNIQUELY IDENTIFIES A SEGMENT (OR DIRECTORY) BY 
ITS POSITION RELATIVE TO THE USER'S WORKING DIRECTORY 



II NEVER BEGINS WITH > (GREATER-THAN) 



D DIRECTORY RELATIVE PATHNAME 

ProjA 
udd>ProjA 

Student__01 
F01>Student 01 

hw_dir 

Student_01>hw dir 
F01>Student OT>hw dir 



D SEGMENT RELATIVE PATHNAMES 

add. pi 1 
Student_01>add.pl1 

lesson_2 
hw_dir>lesson_2 

start_up.ec 
Kerr>start_up.ec 
ProjA>Kerr>start up.ec 



THE WORKING DIRECTORY CONCEPT IS SIMPLY A CONVENIENCE THAT ALLOWS 
THE USER TO TYPE RELATIVE PATHNAMES INSTEAD OF THE LONGER ABSOLUTE 
PATHNAMES 
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PATHNAME CONVENTIONS 



ENTRYNAMES (PATHNAME MEMBER) 



1 TO 32 CHARACTERS LONG 



I SHOULD JOT INCLUDE > < * = ? ^ $ n ( ) SPACE OR TAB 

D _ (UNDERSCORE) 

Q SIMULATES A SPACE FOR READABILITY 
Bobs__orig__eclitor.pl1 

D . (PERIOD) 

D SEPARATES COMPONENTS OF AN ENTRYNAME 
ms__tester .old.fortran 

LAST COMPONENT OF AN ENTRYNAME IS CALLED THE SUFFIX 

D ENTRYNAMES MUST BE UNIQUE WITHIN A DIRECTORY 

II SEGMENTS AND DIRECTORIES MAY HAVE MORE THAN ONE ENTRYNAME 



test. 14_may.new__compiler 

t. 14m. nc 

may__comp 



horaework_dir 

hw__dir 

hw 
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PATHHAME COHVEMTIONS 



NOTICE THAT IN THE SIMPLEST CASE (WHERE A USER LOGS IN CREATF<5 
ifREoSlRED'' "°"' I^^RECTORY FILES) NO KNOWLEDGE OF THE HIERARCHY 
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TOPIC VI 
STORAGE SYSTEM COMMANDS 



Page 

Directory Manipulation Commands ........ 6-1 

Segment Manipulation Commands 6-3 

Storage System Examples [ 6-14 
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This page has Intentionally 
been left blank. 
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DIRECTORY MANIPULATIor COMMANDS 



■ } 
• print_w^ir, pwd (wHere AM I?) 



PRINTS THE PATHNAME OF THE CURRENT WORKING 



DIRECTORY 



D USAGE: print__wdir 
pwd 



change__wpir , jcwd (MOVI OUT! ) 

CHANGES THE USER'S WORKING DIRECTORY 

D USAGE: change^wdir {path} 
cwd dir_A 

cwd >udd>F01>Stud€nt_08>dir A 
cwd 
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DIRECTORY MANIPULATION COMMANDS 



• create^dir, cd^ (UP TO 16 DEEP) 

CREATES AN EMPTY DIRECTORY 

DOES NOT CHANGE THE USER'S WORKING DIRECTORY 

D USAGE: create^dir paths {-control^args} 
cd dir_A 
cd >udd>F01>Student_09>myd 



delete^dir, dd (DO YOU REALLY...?) 

DELETEsNdESTROYS) SPECIFIED DIRECTORIES (AND ALL SUBORDINATE 
DIRECTORIES AND SEGMENTS) 



USAGE: delete^dir paths 
dd programs 
dd >udd>F01>Student_01>programs 
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SEGMENT HANIPULATIQN COMMANDS 



• create, ^r (SELDOM NEEDED) 

1 CREATES AN EMPTY SEGMENT 

D USAGE: create paths 
cr seg_1 

or seg__1 seg__2 A B 
cr >ucld>F01>Stuclent_07>adcI.pl1 



delete, dl 

D DELETES (DESTROYS) SPECIFIED SEGMENTS 

S USAGE: delete paths 

dl seg_1 add.pll 
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SEGMENT MANIPULATION COMMANDS 



• copy, cp 



^.^ ^^ ^f^-^ ^^^^^-^ 



COPIES A SPECIFIED SEGMENT TO A NEW POSITION IN THE HIERARCHY 

D DOES NOT COPY A SEGMENT'S "ADD NAMES" UNLESS REQUESTED 

II USAGE: copy path1 {path2} {-control_args} 

cp >udd>FED>LJones>adcl >udd>FED>LJones>exp>add 

cp >udd>FED>LJones>add add. old 

cp >udd>FED>LJones>add 

cp >udd>FED>LJones>add -name 



•/ move 






.yihs-^^ 



MOVES A SPECIFIED SEGMENT (TO INCLUDE ACL AND ADD NAMES) TO A 
NEW POSITION IN THE HIERARCHY 



1 USAGE: move pathi {path2} {-control__args} 

move >udd>FED>Kerr>dev>x_sort >udd>FED>Kerr>tools>sort 

move >udd>FED>Kerr>dev>x_sort sort 

move >udd>FED>Kerr>dev>x sort 
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SEGMENT MANIPULATION COMMANDS 




• add name, an (ALIAS) 



V ADDS ALTERNATE NAME(S) TO A SEGMENT OR DIRECTORY 
D SUCH NAMES ARE CALLED "ADD NAMES" 
USAGE: add^narae path names 

an >udd>F01>Student_0l>seg l.new sin 



delete_name, dn /i^^^ ^^ 



H 



DELETES NAME(S) FROM SEGMENTS AND DIRECTORIES 

USAGE: delete_name paths 
dn seg 1 .new s1n 
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SEGMENT MANIPULATION COMMANDS 



rename/ rn 



REPLACES A SEGMENT OR DIRECTORY NAME WITH ANOTHER 

Q USAGE: rename pathj^ narae^. . .pathn namen 
rn s_1.n seg_1.new 



• list< Is /(ROLL CALL) 



D RETURNS ATTRIBUTE INFORMATION ABOUT STORAGE SYSTEM ENTITIES 



\ BY DEFAULT ONLY SEGMENTS ARE LISTED 



D USAGE: list {entrynames} {-control args} 




,._.^_iUj. — ' .y^"^"' 



Is 

Is add.pll seg__1 

Is ^-drA . J^'i^.oC^^-^'^ *" A 

Is -all -sort name 

list -date time contents modified 



1.) 



, ^^ 
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SgGMENT MAillPULAtlON COMMANDS 



status, St (WHO, WHAT, WHERE, AND 



WHEN) 



" ?NCl5SiNg''''"' information about SEGMENTS JiND_^IRECTOHIES. 
D DATE AND TIME MODIFIED, USED AND DUMPED 
D User^id OF AUTHOR AND User__id OF LAST MODIFIER 
SIZE, ACCESS CLASS, ACCESS MODES, RING BRACKETS 

D USAGE: ^ status paths {-control^args} 

- st seg_1 

- St seg__1 -length 

- st seg__2 -author -date 



print, £r Jx\ .LET'S SEE WHAT YOU LOOK LIKE) 
PRINTS THE CONTENT S OF A SEGMENT 

fl USAGE: print path {begin} {end} 
pr seg_1 
pr add.pll 150 
pr prince 40 120 
pr >udd>F01>Student__08>add.pl1 
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SEGMENT MANIPULATION COMMANDS 



• compose, comp (PLASTIC SURGERY) 



FORMATS TEXT SEGMENTS INTO MANUSCRIPT FORM 



^nSUnnPciJl/SI ^^^^ ^"^^^^ ^F compin AND NORMALLY CONTAIN 
CONTROL STATEMENTS WHICH DRIVE THE FORMATTING 



" oLSt^HI ^^ DIRECTED TO A SEGMENT, THE ENTRYNAME IS GIVEN A 
SUFFIX OF compout 



n THTQ PAMMAMn Dcni a/m^o .ntir* -. - _ _ _ 

*»*« «wiin«ni/ ncrj^noco inc TUnoiI UUMMAND . AND PROVIDF^ A 

SUPERSET OF THE runoff CAPABILITIES TO INCLUDE INLINE ARTWORK- 



D USAGE: compose paths {-control_args} 
comp thesis .compin 
comp thesis. compin -in 10 -of -dv dtcSOOs -pass 2 
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SEGMENT MANIPULATION COMMANDS 



dprint, dp (START THE PRESSESi) 



D QUIUE| A^^REQUEST^TO PRINT THE CONTENTS OF A SPECIFIED SEGMENT 



THE USER MAY SPECIFY ONE OF THREE PRIORITY QUEUES (QUEUE "3" IS 
ASSUMED - LOWEST PRIORITY, LOWEST COST) 



PROCESsf^^^ ^^ ^^^^ ^^ °^^ °^ ^"^ ^^^™ DAEMONS (A SERVICE 



USAGE: dprint {-control__args} {paths} 
dp seg_1 

dp -cp 4 ~ds MD_104 seg_1 
dp seg__l -cp 3 seg_2 -ds Bldg_4 seg_3 
dp -he »'Tom Smith" -notify seg__l add. pi 1 
dp -delete -q 1 Prince 

DEFAULTS: -cp 1, -ds Project_id, -he Person_id, -q 3 
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SEGMENT MANIPULATION COMMANDS 



dpunch, dpn (START THE PUNCHESI) 



QUEUES A REQUEST TO PUNCH THE CONTENTS OF A SPECIFIED SEGMENT 
ON THE CARD PUNCH ^rc^.±^llLu DLunLWi 



" rS2u?2J:.o^^^""^^" ^^^ DEFAULTS ARE THE SAME AS THE dprint 
COMMAND 'S 

fl USAGE: dpunch {-control_args} {paths} 

dpn -he Larry -ds "Room 21" prince 



list__daemon_requests, Idr J 

L . '■■■ 



USAGE: list_daemon__requests {-control args} 
Idr 
Idr -queue 1 
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SEGMENT MANIPULATION COMMANDS 



cancel_daemon__request , cdr 



V 



° ?n?^«Mf/T<='*'"'^"*' °L '^P""°'' REQUEST IN THE QUEUE SPECIFIED 
KutrAuLJ IS -queue 3) 



D USAGE: cancel__daemon__request request_id {-control__args} 
cdr prince 
cdr -id 202008 
cdr -entry prince 



• walk__subtree, ws (AND DON«T COME BACK UNTIL YOU ARE THROUGH!) 

EXECUTES ANY SUPPLIED COMMAND LINE IN A SPECIFIED DTRFfTORY 
AND ALL INFERIOR DIRECTORIES ^t-c^ifiLD DIRECTORY, 

11 A LIBRARY MANAGEMENT TOOL 

II USAGE: walk__subtree path "command_line" {-control^args} 
ws >udd>F01 "list -all" 
ws -wd "sa *» r ».».»»» 
ws ^wd? "da LJones.«.«" -bottom up 
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STORAGE SYSTEM EXAMPLES 



NOTE: THE READY MESSAGE IS NOT SHOWN IN THE FOLLOWING TERMINAL 
SESSION 



W DIR 



\ 



V 



student 01 



i>Mm-' 



pwd 
>udd>F01>Student^01 

Is 
~T)irectory empty. 

qx 

a 

add: proc 

end add 

\f 

w add.pH 

q 

cr seg_1 Prince 
cd hw dir 



(print wdir) 
(outpu*^) 

(list) 
(output) 

(qedx) 

(append mode) 

(text) 

(text) 

(edit mode) 

(write) 

(quit) 

(create) 

(create dir) 



W DIR 
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STORAGE SYSTEM EXAMPLES 



pwd 
>udcl>F01>Student_01 

Is 

Segments = 3, Lengths s 1, 



r w 
r w 
r w 



Prince 

seg_1 

1 add.pll 



Is -sort name -all 
Segments = 3, Lengths r i. 



r w 
r w 
r w 



1 add. pi 1 
seg_1 
Prince 



Directories = 1 . 
sma hw dir 

cr hw__dir>lesson_1 .math 

cwd hw_dir 

pwd 
>udd>F01>Student_01>hw__dir 

cr lesson_12.eng 



(print__wdir) 
(output) 

% X Jb ^ tf / 

(output) 
(output) 
(output) 
(output) 
(output) 
(output) 

(list) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(create) 

(change__wdir) 

(print_wdir) 
(output) 

(create) 



6-15 



F01 



STORAGE SYSTEM EXAMPLES 






W DIR 



\. 



hw dir 



add.pll 



lesson_12.eng 



lesson l.math 
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STORAGE SYSTEM EXAMPLES 



Is lesson__12»eng 
Segments = 1, Lengths = 0. 
r w lesson_12.eng 
Is -sort name -reverse(-dtu^' 
Segments = 2, Lengths = 0. 



_^ 






09/13/77 0849.2 r w 
09/13/77 0849.1 r w 

t cwd 

! pwd 

>udd>F01>Student 01 



lesson_12.eng 
lesson 1 .math 



(list) 

(output) 

(output) 

(output) 

(output) 

(list) 

(output) 

(output) 

(output) 

(output) 

(output) 

(change_wdir) 

(print_wdir) 
(output) 



dp add. pi 1 

1 request signalled, 22 already in queue 3 

ws -wd "Is -brielf" " -^^n^^r^'^^ 
>udd>F01>Student_01 
Segments = 3, Lengths = 1. 

Prince 

seg__1 

add.pll 

>udd>F01>Student__01>hw_dir 
Segments = 2, Lengths = 0. 

lesson__12.eng 
lesson 1 .math 



(dprint) 
(output) 

(walk_subtree) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 

(output) 



YOU ARE NOW READY FOR WORKSHOP 
#3 
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TOPIC VII 
THE COMMAND LANGUAGE 



Page 

What is a Command Y^l 

Command Arguments .......!].*.'].'].*.**'*' jZi^ 

Common Control Arguments ... 76 

Star Convention .....]'*'''''*' v'y 

Subsystems , 7-^0 
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WHAT IS A COMMAND 



COMMAND PROCEDURE 

I A PROGRAM . USUALLY WRITTEN BY A SYSTEMS PROGRAMMER 

D RESIDES IN ONE OF THE SYSTEM'S LIBRARIES 

D EXECUTED BY TYPING ITS NAME 

I DESIGNED TO 

PERFORM EXPECTED TASK 

D ACCEPT AN ARBITRARY NUMBER OF ARGUMENTS 

1 REPORT TYPING ERRORS 

I HANDLE OTHER USER ERRORS 
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WHAT IS A COMMAND 



• COMMAND 



° cSSmaSS'pROCEDURe"'"' ^'''"' " "' """'"*' ^° ^"^^"^^ * SPECIFIC 



D EXAMPLES: 

" THE §g^3.P«°gEP"«E acoept_niessages IS INVOKED BY TYPING 

accept_messages 
am 

° cSmMaB ^ procedure print IS INVOKED BY TYPING THE 

print seg__l 

pr treasure hunt 
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WHAT IS A CQMHAHt) 



COMMAND LINE 



A LINE TYPED AT THE TERMINAL WHEN AT MULTICS COMMAND LEVEL 

MAY BE ONE COMMAND 

accept_messages 
am 

print seg_1 

MAY BE A MISTYPED COMMAND 
prirat seg__1 

MAY BE MORE THAN ONE COMMAND SEPARATED BY SEMI-COLONS 

accept_messages; pr seg_1 

am; print start_up.ec; who 

\ 
MAY BE NULL (I.E., JUST A LINEFEED) ( /^o^^^^^r-^^^^^^ ^J^J^^J^J 



FREE FORMAT ACCEPTED (EXTRA SPACES ARE IGNORED) 

list -all; sra LJones.FED teCO is ready! 

print add.pll 
am;pm;who 
ani ;pm; who ;; 
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COMMAND ARGUMENTS 



ARGUMENTS 



D A SERIES OF CHARACTER STRINGS THAT FOLLOW A COMMAND 



• PATHNAME ARGUMENTS 



^ T^ ACt"^^ °^ SEGMENTS OR DIRECTORIES UPON WHICH THE COMMAND IS 

cwd >udd>F01>Student 01 
print seg 1 



• CONTROL ARGUMENTS 



m^TAsf ^"^^ "°^^^^ ^"^ ^^^^^^ ^^ ^"^^" ^"^ ^°""AND PERFORMS 



ALWAYS START WITH A - (MINUS) 
list -segment 
list -directory 
list -all 
list seg_1 -date time used 
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COMMAND ARGUMENTS 



ARGUMENTS OF CONTROL ARGUMENTS 

dprint -copy 2 -ds MS__102 add.pll 
dp -cp 2 -ds '"MS 102" add.pll 
set___tty -modes crecho 
memo -time Sara WAKE UP! 



• OTHER ARGUMENTS 

sm Student__04.F01 Going to lunch? 
print seg__2 15 40 
login TSmith 



• NO ARGUMENTS 



^^"^ print_wdir 

defer__messages 



3^~^Hyj^^^ (HURRAH FOR DEFAULTS! 

rp7^ -ch^ge_wdir {Home Directory} 

^''- print seg__2 {first last} 
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COMMON CONTROL ARGUMENTS 



LONG FORM 


SHORT FORM 


-all 


-a 


-brief 


-bf 


-copy n 


-cp n 


-directory 


-dr 


-long 


-Ig 


-optimize 


-ot 


-print 


-pr 


-queue n 


-q n 


-segment 


-sm 


-table 


-tb 


-time {dt} 


-tra {d1 


-totals 


-tt 



USUAL MEANING 

OPERATE ON ALL TYPES OR ALL ENTRIES 

SHORTEN THE VERBOSITY AND/OR 
CONTENTS OF RESPONSE 

CREATE n COPIES 

OPERATE ON DIRECTORIES 

INCREASE THE VERBOSITY AND/OR 
CONTENTS OF RESPONSE 

OPTIMIZE GENERATED CODE (FOR 

rr\MDTI CDC \ 

W\^ilt JL t^ Lj l\ %JI / 

PRINT A STATUS OR SUMMARY REPORT 
USE PRIORITY QUEUE n 



OPERATE ON SEGMENTS, OR SEND OUTPUT 
TO A SEGMENT 



GENERATE A 
COMPILERS) 



SYMBOL TABLE (FOR 



DELAY UNTIL THE SPECIFIED TIME, OR 
GENERATE TIMING STATISTICS 

PRINT TOTALS 
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STAR CONVENTION 



• STAR CONVENTION 



JLMATCHES ANY SINGLE COMPONENT OF AN ENTRYNAME 
JLMATCHES ANJ5^ GROUP OF COhtEnMEHia. IN AN ENTRYNAME 
^.MATCHES ANY CHARACTER IN A COMPONENT OF AN ENTRYNAME 



• ASSUME SOME DIRECTORY CONTAINS THE FOLLOWING SEGMENTS: 

a fortran seg 1.pii 

ad.fortran seg~1.new 

3^^-Pl1 seg~1.old 

"^^ ^ seg_1.old.pll 

new. a. fortran seg__1 .old. test .pll 



• EXAMPLES USING THE list COMMAND (THE list HEADER IS NOT SHOWN) 



list seg_1.pii seg__1.new seg__1.old 

rw 1 seg_1.pii 
rw 2 seg_1.new 
J^w 1 seg l.old 
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STAR CONVENTION 



list seg 1 .* 



rw 1 seg__1.pl1 

rw 2 seg__1 .new 

rw 1 seg l.old 



list seg 1.».» 



rw 1 seg_1 .new.cobol 

rw 2 seg_1 .old.pll 



list new.** 



rw 




1 new 



1 M^.. » X*^^*.^ 

I new . a • 1 <^f ui elll 



list ».pl1 



rw 
rw 



1 add.pH 
1 seg__1.pl1 



list »«.pl1 



rw 
rw 
rw 
rw 



1 add.pH 

1 seg_1.pl1 

2 seg_1 .old.pll 

1 seg_1 .old. test. pl1 



list «.«.».» 

rw 1 seg_1. old. test. pl1 



list a» 
rw 






/>^ 



.,/ 



C^"^'- 



;^- 



1 add 
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STAR CONVENtiON 



list s*.*.pli 

rw 2 seg_1.old.pl1 



list s*.»».p» 
rw 



1 seg_1.pll 
rw 2 seg_1 .old.pll 
rw 1 seg__1. old. test. pll 



list ??? 



rw 1 add 
rw 1 new 



list a?.» 
rw 


1 


ad.fortran 


list a?«.» 

rw 
rw 


1 
1 


ad.fortran 
add. pll 


list ad«.*» 







rw 1 add 

rw 1 add. pll 

^w 1 ad.fortran 



list »* 

<all segments> 
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SUBSYSTEMS 



• SUBSYSTEM 



A COLLECTION OF PROGRAMS THAT PROVIDE A SPECIAL ENVIRONMENT FOR 
SOME PARTICULAR PURPOSE 



fl EDITING 

edm 
qedx 



CALCULATION 



<U«IXC 



fl DEBUGGING 

probe 
debug 



D A USER ENTERS A SUBSYSTEM BY COMMAND AND EXITS THE SUBSYSTEM BY 
REQUEST 



fl TYPED LINES ARE INTERPRETED BY THE SUBSYSTEM, NOT BY THE 
MULTICS COMMAND PROCESSOR; THEREFORE, THEY ARE NOT COMMAND 
LINES 



D THE SUBSYSTEM MAY PERFORM ITS OWN REQUEST PROCESSING. FILE 
HANDLING, AND ACCOUNTING 
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SUBSYSTEMS 



REQUEST LINE FLOW 

TYPED LINE 

i 

FRONT-END PROCESSOR 

▼ 

SUBSYSTEM 

1 

EXECUTION 



• COMMAND LEVEL 



SSLTrcs'cOMMfSDlROc'E^sL"^'^" ''''' "■'''' ^"^ INTERPRETED BY THE 



TYPED LINES ARE REFERRED TO AS COMMAND LINES 



• SUBSYSTEM LEVEL 



s{]BSYS?Ef ' ''*'' '" ''«'^" "PE-^ LINES ARE INTERPRETED BY THE 



TYPED LINES ARE REFERRED TO AS REQUEST 



LINES 
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TOPIC VIII 
EXEC COM BASICS 



Page 

What is an Exec_com ; g 4 

Exec com Mechanism ...!!]'*'***' q~p 

Star"E__up Exec^coms •••........ o-^ 
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WHAT IS AN EXEC COM 




EXEC__COM 

B A SEGMENT THAT CONTAINS A SERIES OF COMMAND LINES 
fl MAY BE CREATED USING A TEXT EDITOR 

I SEGMENT NAME MUST HAVE A SUFFIX OF ec 
A.ec 
print. ec 
start__up.ec 

" III exrcL^COHMASr '''''''" SEQUENTIALLY. AS A SET, BY USING 



^-'' F01 



EXfeC COM MECHANISM 



yCjZ-?^^-^^ ^^^-^^^---^f^ 



exec /com, ec, -' 



D EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC COM SEGMENT 



" rvSJJnJJS ^^"^^ ^"^ PRINTED ON THE USER'S TERMINAL AS THEY ARE 
EXECUTED 



USAGE: exec_com path 
ec A.ec 
ec print. ec 
ec start__up.ec 



• EXEC_COM LINE FLOW 

EXEC COM LINES 



I 



COMMAND PROCESSOR 



I 



EXECUTION 
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EXEC COM MECHANISM 



EXAMPLE: 



LET THE SEGMENT print.ec CONTAIN THE FOLLOWING TEXT 
print. ec 



cwd >udd>F01>Student 07 
Is - 

pr seg_1 

logout 



TYPING THE ONE COMMAND 

ec print.ec 
HAS THE SAME EFFECT AS TYPING THE FOUR COMMANDS ABOVE 
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START UP EXEC COMS 



START UP EXEC COM 



D HAS THE NAME start__up.ec 



D LOCATED IN USER'S HOME DIRECTORY 



FSlm^SsERifLOG^^^^ WITHIN ARE AUTOMATICALLY EXECUTRn 



S CAN ALSO BE INVOKED MANUALLY 
ec start_up.ec 




-<^^^ SET-UP USER'S ENVIRONMENT 

I 



D CHECK ON EVENTS SINCE LAST LOGIN 



D PERFORM ANY DESIRED TASKS AT LOGIN 
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START UP EXEC CDMS 



EXAMPLE: LET THE SEGMENT start-up. ec CONTAIN THE FOLLOWING TEXT 



start up,ec 




THESE TWO COMMANDS ARE AUTOMATICALLY EXECUTED FOR THE USER AT 
LOGIN 



• ?Se'^ys??m^s'SeS'^ '''''''' '^' '''''''' '' 
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START UP EXEC COMS 



• print_motd, ptnotd 



Q PRINTS OUT THE MESSAGE OF THE DAY IF THE USER HASN'T SEEN IT 



D CREATES AND USES A HQME DIRECTORY SEGMENT NAMED person id.motd 



THIS COMMAND IS NORMALLY FOUND IN USER'S start up.ec 



Q USAGE: print motd 
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TOPIC IX 
THE ABBREV PROCESSOR 



Page 

What is the Abbrev Processor . . ' 9-1 

Abbrev Mechanism 9-2 

Abbrev Requests 9-^ 

Abbrev Examples 9-8 
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V^HAY is THE ABBREV PROCESSOR 



• ABBREV PROCESSOR 



C0MMA5D'?T'«Rt'"'""° ""'"" ^° ABBREVIATE PARTS OF (OR WHOLE) 



COMMAND LINES 

" tABBREv' hSdE) ""''" ""'' '' EXPLICITLY INVOKED BY THE USER 

fl FUNCTIONS 

I RESPOND TO ABBREV REQUEST LINES 

fl EXPAND ABBREVIATIONS IMBEDDED IN COMMAND LINES 
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ABBREV MECHANISM 



• abbrev, ab 



//^ 




D PLACES THE USER IN ABBREV MODE. (INVOKES THE ABBREV PROCESSOR) 

D USAGE: abbrev 
ab 



• COMMAND LINE FLOW 



TYPED LINE 



i 



FRONT-END PROCESSOR 



i 



{ABBREV PROCESSOR} 



i 



COMMAND PROCESSOR 



i 



EXECUTION 



:^ 



^. 



y 



t/* 




!^' 
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ABBREV MECHA!IISM 



• ABBREV MECHANISM 

D ABBREV PROCESSOR EXAMINES TYPED COMMAND LINES 

II ABBREV REQUEST LINES 
II BEGIN WITH "." 

fl I^EFINE, DELETE, LIST ABBREVIATIONS 
II CONTROL OTHER ABBREV OPERATIONS 

command lines 

11 do not begin with " . •» 

° expandeV •'«^^^°"sly defined abbreviations found are 

1 '=°"«*«^ ^^NE IS THEN PASSED ON TO THE COMMAND PROCESSOR 
' ^^S^-^ilrf?f^"*^''^*^«^^ IN A HOME DIRECTORY SEGMENT NAMED 
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ABBREV REQUESTS 



- A 

' J 

• .a. 



ADD AN ABBREVIATION TO THE USER»S PROFILE SEGMENT 
D ABBREVIATIONS MUST BE 8 CHARACTERS OR LESS 

1 USAGE: .a abbrev rtieahing-of-abbreviation 

.a F1 >udd>F01 

.a LARRY LJones.FED 

. ab 



ADD AN ABBREVIATION WHICH IS VALID ONLY AT THE BEGINNING OF A 
COMMAND 



S USAGE: .ab abbrev raeaning-of-abbreviation 

.ab dp dprint -he T.Smith -ds Stat_14 

.ab cata list 

•ab GO ec run it.ec 
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ABBREV REQUESTS 






<i/ 



Q DELETE SPECIFIED ABBREVIATION(S) FROM THE USER^S PROF 



ILE 



D USAGE: .d abbrevj_...abbrevn 
.d LARRY 







^\ 


1 


•^ 


J 


V 


y' 





LIST CURRENTLY DEFINED ABBREVIATIONS AND WHAT THEY STAND 



FOR 



D USAGE: .1 {abbrevl...abbrevn} 
.1 
.1 F1 dp 



la 



LIST ABBREVIATIONS THAT BEGIN WITH THE SPECIFIED LETTERS 



(S) 



USAGE: .la letteM . . .lettern 
.la m 
.la m d 
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ABBREV REQUESTS 





QUIT USING THE ABBREV PROCESSOR 

W 

D USAGE: .q 



.s 






U LArAWi; ANi; SHUW TMt: COMMAND LINE WITHOUT EXECUTING IT 

USAGE: .s text 

.s cwd F1 ; dp add.pll 
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ABBREV REQUESTS 



EXECUTE THE COMMAND LINE WITHOUT EXPANDING IT 



D USAGE 1: . text 

(DON'T EXPAND) 

. print A. lunch. cb 



USAGE 2: 

(ACKNOWLEDGE) 



WITH°"ab"f ™*' ™ ""'" ^2 I« *^^«" "ODE (ABBREV RESPONDS 



S hesIageVf""" command level when "multing-. with the 



9-7 

^ ' F01 



ABBREV EXAMPLES 



LET TSmith's PROFILE SEGMENT CONTAIN THE FOLLOWING ABBREVIATIONS 



ft fortran 

CD cobol 

LARRY LJones.FED 

home >udd>ProjA>TSmith 

F1 >udd>F01 

lunch sm LJones.FED Lunch time! 

b dp dprint -he TSMITH -ds Stat 14 



EXAMPLES OF COMMAND LINE EXPANSION (IF IN ABBREV MODE) 

print array_dot.ft 
print array_dot. fortran 



sm LARRY Where's your dims program? 

sm LJones.FED Where's your dims program? 



cwd F1>Student_01 

cwd >udd>F01>Student 01 



dp add.pll 

dprint -he TSmith -ds Stat__14 add.pll 



list dp. ft 
list dp. fortran 



lunch 

sm LJones.FED Lunch time! 
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ABBREV EXAMPLES 



print A. lunch. cb 

print A.sm LJones.FED Lunch time! .cobol 



. print A. lunch. cb 
print A. lunch. cb 



. print A. lunch. cobol 
print A. lunch. cobol 



print clunch.cb 
print clunch, cobol 



print A_lunch.pll 
print A__lunch.pll 



• CANDIDATES FOR EXPANSION MUST BE 



PART OF COMMAND LINE (MAY BE THE ENTIRE COMMAND LINE) 
CHARACTER STRING, 8 CHARACTERS OR LESS, THAT ARE 



BOUNDED BY BREAK CHARACTERS 



NOTE : 



tab 
newline 


> 


< 

> 


space 

n 

$ 
t 


) 

1 
1 

( 

) 


c 
] 
{ 

} 



^ : AND ? ARE NOT A BREAK CHARACTERS! 
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ABBREV EXAMPLES 



YOU ARE NOW READY FOR WORKSHOP 
#4 
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TOPIC X 
PROGRAMMING ON MULTICS 



Page 

What is Programming ^q_,^ 

Developing a Source Program ......!!!!.'.*.* .* .' io-4 

Compiling a Source Program . , . io-7 

Entrynames and Entry Point Names , , 10-11 

Executing an Object Program . . [ 10-n 

Debugging Tools , , 10-18 

Dynamic Searching [ [ 10^21 



ro-i poi 



This page has intentionally 
been left blank. 



10-ii F01 



WHAT IS PROGRAMMING 



PROGRAM 

3 A LOGICAL SEQUENCE OF OPERATIONS TO BE PERFORMED BY A COMPUTER 
II SOURCE PROGRAM 

D WRITTEN IN AN ENGLISH-LIKE PROGRAMMING LANGUAGE 

11 CREATED BY A USER VIA A TEXT EDITOR 

I KEPT IN A SEGMENT CALLED THE SOURCE SEGMENT 

fl CANNOT BE EXECUTED 

D OBJECT PROGRAM 

WRITTEN IN BINARY MACHINE LANGUAGE 

° tSe'soSrce prograT'" '"'''' '' '''° *" °''''' '''^^'^^ ^"^^ 

1 KEPT IN A SEGMENT CALLED THE OBJECT SEGMENT 
II EXECUTED BY TYPING ITS NAME 
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WHAT IS PROGRAMMING 




PROGRAMMj ENG LANGUAGES S U PPORTED BY MULTICS(1) 

4j__?L/l-- (VERSATILE, BLOCK STRUCTURE, DYNAMIC ALLOCATION, 
"TrEinTRSIVE, MANY DATA TYPES) 



FORTRAN (SCIENTIFIC COMPUTATIONS) ^^y^ ' 

COBOL (BUSINESS APPLICATIONS, VERBOSE, WIDELY USED) 

D BASIC (COMPUTATIONS, EASY TO LEARN, LIMITED DATA TYPES) 

D APL (DATA MANIPULATION, CRYPTIC BUT POWERFUL) 

D ALM (MULTICS ASSEMBLER LANGUAGE - YES! WE HAVE AN ASSEMBLER) 



• THERE EXISTS A SYSTEM PROGRAM, CALLED A COMPILER, FOR EACH 
PROGRAMMING LANGUAGE SUPPORTED. COMPILERS ARE DESIGNED TO 
TRANSLATE A PARTICULAR PROGRAMMING LANGUAGE INTO MACHINE LANGUAGE 



(1) RELATED MULTICS COURSES: APL (G11 & F11), BASIC (F127), COBOL-74 
(F13), FORTRAN (F14), PL/I (F15, F15C, F15D). 
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WHAT IS PROGRAMMING 



PROGRAMMING 



n DEVELOPING THE SOURCE PROGRAM IN THE PROGRAMMING LANGUAGE OF 

" lS?"Aj"yS*SS°i0B^5E^TSlNTf^^ ^^°"-^ ^-"^-^ 
D EXECUTING THE OBJECT PROGRAM USING TEST DATA 

n DEBUGGING THE SOURCE PROGRAM TO CORRECT ALL OBSERVED PROBLEMS 
1 MAKING THE OBJECT PROGRAM AVAILABLE 

" UBRfRIEs'°°'*"' ""'' ^' "INSTALLED" IN ONE OF THE SYSTEM 

" A^^Ls^''?S''ll!L%f gs^E b"? ^T^S^f SsL^s""" ^^^"^ ^"^ ^"^^"'^ °^ 
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DEVELOPING A SOURCE PROGRAM 



# DESIGNING (OUTLINING) A SOURCE PROGRAM 



fl TOP-DOWN DESIGN 



D MODULAR DESIGN 



D FLOWCHARTING 






D EXTERNAL DOCUMENTATION (PURPOSE, GENERAL DESIGN, HOW TO USE) 



INTERNAL DOCUMENTATION (STEP BY STEP DESCRIPTION OF THE 
PROGRAM) 



"SELF-DOCUMENTING" LANGUAGES 



• WRITING (CODING) THE SOURCE PROGRAM (USUALLY ON PAPER) IN SOME 
PROGRAMMING LANGUAGE 



1 "GO-TO-LESS" PROGRAMMING 



I! MNEMONIC VARIABLE NAMES 
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DEVELOPING A SOURCE PROGRAM 



I ERROR DETECTION AND HANDLING 



• INPUTTING THE SOURCE PROGRAM, VIA A TEXT EDITOR, TO A SOURCE 
SEGMENT 



D A SOURCE SEGMENT MAY BE GIVEN ANY DESIRED NAME, HOWEVER, THE 

SUFFIX MUST BE THE ENTRYNAME OF THE PROGRAMMING LANGUAGE USED 

add.pll ran_num_gen. basic 

A__alpha.cobol page_fault .aim 

array dot.fortran 





OPTIONALLY FORMATTING THE SOURCE PROGRAM (COSMETICS) 



B SEVERAL COMMANDS EXIST FOR THE PURPOSE OF FORMATTING SOURCE 
PROGRAMS 



fl DONE TO IMPROVE THE READABILITY OF A SOURCE PROGRAM 



THE COMMANDS DETECT AND REPORT CERTAIN TYPES OF SYNTAX ERRORS, 
AND ARE OFTEN USED AS A PRE-COMPILE EXAMINATION 
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DEVELOPING A SOURCE PROGRAM 



indent, ind 

fl IMPROVES THE READABILITY OF A PL/1 SOURCE SEGMENT 

— « — - -i...»-^ww ^awiii lyaifiicj luOntroi arg} 
ind add.pll add.ind.pl1 
ind add.pll 

ind >udd>F01>Student__09>add.pl1 -indent 3 

i format__cobol_source, fcs 

D CONVERTS FREE-FORM COBOL SOURCE PROGRAMS TO FIXED-FORMAT 

fl USAGE: forraat__cobol_source pathi path2 

fcs A_alpha.cobol A_alpha .fcs.cobol 
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COMPILIHG A SOURCE PROGRAM 




COMPILER 



I A SYSTEM PROGRAM DESIGNED TO TRANSLATE A PARTICULAR PROGRAMMING 
LANGUAGE (ENGLISH-LIKE) INTO MACHINE LANGUAGE (BINARY) 



COMPILE COMMANDS (CREATE OBJECT PROGRAM AND OBJECT SEGMENT!) 



fl USAGE: language_name path {-control_args} 
pll add.pll 

pl1 >udd>F01>Student_09>add.pl1 
cobol A_alpha.cobol 
fortran array_dot .fortran 
basic ran_num_gen. basic 
aim page fault. aim 



• OBJECT PROGRAMS 

D ALL OBJECT PROGRAMS PRODUCED BY MULTICS COMPILERS ARE 
D PURE (DO NOT MODIFY THEIR OWN CODE) 



fl JE -ENTRA NT (MORE TH|LN ONE USER MAY EXECUTE THE SAME CODE) 
D RECURSIVE (A PROGRAM CAN CALL ITSELF) 

e IN STANDARD FORMAT (OBJECTS GENERATED FROM DIFFERENT 
LANGUAGES MAY CALL EACH OTHER EASILY) 
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COMPILING A SOURCE PROGRAM 




fl 



D THE OBJECT PROGRAM IS PLACED IN A SEGMENT (CALLED THE OBJECT 
SEGMENT) IN THE USER'S WORKING DIRECTORY 



THE OBJECT SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
ENTRYNAME WITH THE SUFFIX REMOVED 



add ran__num_gen 

A_alpha page_fault 

array dot 



COMPILER LISTINGS 



SOME CONTROL ARGUMENTS WILL CAUSE A COMPILER TO PRODUCE A 
COMPILER LISTING OPTIONALLY CONSISTING OF A LINE-NUMBERED 
SOURCE LISTING, A SYMBOL TABLE, AN OBJECT CODE MAP, ERROR 
MESSAGES, ETC. 



THE COMPILER LISTING IS PLACED IN A SEGMENT (CALLED THE LIST 
SEGMENT) IN THE USER'S WORKING DIRECTORY 



THE LIST SEGMENT IS GIVEN THE CORRESPONDING SOURCE SEGMENT'S 
NAME WITH THE ORIGINAL SUFFIX REPLACED BY THE SUFFIX list 

add. list ran_num_gen .list 

A_alpha.list page_fault .list 

array dot. list 
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COMPILING A SOURCE PROGRAM 



• DIAGNOSTICS 

i COMPILERS WILL COMPLAIN ABOUT: 
SYNTAX ERRORS 
D MISSPELLINGS 
UNDEFINED REFERENCES 

D ERROR MESSAGES ARE PRINTED AT THE USER'S TERMINAL 



SEVERE ERRORS WILL SUPPRESS THE FORMATION OF THE OBJECT PROGRAM 
AND OBJECT SEGMENT 



THE FORMAT OF ERROR MESSAGES IS COMPILER-DEPENDENT. THE 
FOLLOWING IS A PL/I ERROR MESSAGE: 



ERROR 158, SEVERITY 2 ON LINE 30 

A constant immediately follows the identifier "zilch" 

SOURCE: a = zilch 4; 
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COMPILING A SOURCE PROGRAM 



OBJECT 
PROGRAM 



PRODUCES 



WRITTEN 

(BY COMPILER) 

INTO 



OBJECT 
SEGMENT 
(add) 



-IDEAS- 



DEVELOPED 
INTO 



SOURCE 
PROGRAM 



WRITTEN 
(VIA EDITOR) 
INTO 



SOURCE 
SEGMENT 
(add.pll) 



INPUT TO 



FORMATS 



INPUT 
TO 



COMPILER 
(A PROGRAM) 



OPTIONALLY 
PRODUCES 



FORMATTING 
PROGRAM 



SOURCE 
LISTING 



WRITTEN 

(BY COMPILER) 

INTO 



LIST 
SEGMENT 
(add. list) 
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ENTRYNAMES AND ENTRY POINT NAMES 



A i 






• ENTRYNAME ( 



1 A NAME GIVEN TO AN ITEM CONTAINED IN A DIRECTORY / ^i 



ENTRY POINT NAME 



fl THE NAME ASSOCIATED WITH AN ENTRY POINT IN AN OBJECT SEGMENT 



• UNLESS OTHERWISE SPECIFIED, MULTICS ASSUMES THE ENTRY POINT NAME 
IS THE SAME AS THE ENTRYNAME 



/ ^^ 



mAi^.^ 



^j^/eci<'^/^^ C^^^ 



-6rY S-'J^^ ^ . ~^v^ ^^ 







'/-T^' 
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EtiTRYHAMES AND ENTRY POINT NAMES 



\. 




$ (DOLLAR SIGN) 



D SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT 



II EXAMPLE USING AN OBJECT SEGMENT add HAVING ENTRY POINTS add AND 
max 



^ 



/'■^ 



add 



S^' 




INVOKED 
AS 


INTERPRETED 
AS 


ENTRY 
POINT 


add 


add$add 


add 


addlmax 


add$max 


max 


max 


max$max 


? 



/? 



EXAMPLE AS ABOVE WITH ALIAS NAME max ADDED TO THE SEGMENT 






^^pW 



k" 



^\ 




INVOKED 


INTERPRETED 


ENTRY 


AS 


AS 


POINT 


add 


add$add 


add 


add$max 


add$max 


max 


max 


max$max 


max 
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EXECUtlNq AN OBJECT PROGRAM 



AN OBJECT PROGRAM (OBJECT SEGMENT) IS EXECUTED BY TYPING ITS NAME 
AT A TERMINAL 



add 

A_alpha 
array dot 



ran_num_gen 
page_fault 
>udd>F01>Student 09>add 



• POSSIBLE RESULTS OF EXECUTING A PROGRAM 



B PROGRAM RUNS TO NORMAL TERMINATION & USER RECEIVES READY 
MESSAGE 



D PROGRAM PAUSES FOR INPUT FROM THE USER'S TERMINAL 



PROGRAM HALTS BECAUSE OF A USER-IMPLANTED BREAKPOINT (A 
DEBUGGING TOOL) 



D PROGRAMHAI^IS BECAUSE OF A FATAL EXECUTION ERROR 



D OVERFLOW UNDERFLOW, DATA CONVERSION ERROR, . UNDEFINED 
REFERENCE 



HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND, 
(FROZEN IN MID-AIR) 



D RESPONDS WITH A READY MESSAGE CONTAINING A level CLAUSE 



r 1038.5 0.185 0.012 27 'level 








.y 
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EXECUTING AN OBJECT PROGRAM 

D PROGRAMJiALIS BECAUSE US EB^TSS UED A QUIT SIGNA L^ 

fl TERMINAL KEY LABELED ATTN, BRK, INTRPT, INTERRUPT,... 

D HALTS (INTERRUPTS) THE EXECUTION OF A PROGRAM OR COMMAND 
(FROZEN IN MID-AIR) 

D RESPONDS WITH A READY MESSAGE CONTAINING A level CLAUSE 
r 1038.5 0.185 0.012 27 level 2,11 
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EXECUTING AN OBJECT PROGRAM 



THE USER»S STACK (A HISTORY OF CURRENT EVENTS) 



1 user.init.admin — $ uier.init^admin. 



2 process . overseer _ $ process—oversetr— 



■User logs in. 

— Given default overseer. 



3 listen _ $ listen- 



level 1.3 



Receives ready message. 
User types "add". 



4 abbrev _ $ abbrev— 



■Abbrev processor called. 



5 command_proMssor_$ command__proceisor_ 



"add" requests 
terminal read 
and then 
User hits "break 



6 comm^nd_procestor— $ read— list 



7 add $ add 



read J\ I [ 
waits. • V i 



Command line 
is interpreted. 

Program "add" 
begins execution. 



8 tty-$ tty-get-line 



System 
recovers 
from "Break" 



9 ipc— $ block 
I \| I 10 return_to— ring—O— $ return_to-.ring_0_ 



default_error-.handler_$ wall 



User receives 
level 2, 14 
ready message. 



I I ^ 



get_to— cl— $ unclaimed—Signal 



13 I isten_.$ release—Stack 



level 2, 13 
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EXECUTING AN OBJECT PROGRAM 



• POSSIBLE USER ACTIONS AFTER A QUIT SIGNAL OR FATAL ERROR 

IGNORE THE OLD LEVEL(S) AND PROCEED ( EXPENSIVEJ 

D OBSERVE WHAT WAS HAPPENING USING DEBUGGING TOOLS 
value k 
value qty_on__hand 

D CHANGE VALUES OF VARIABLES USING DEBUGGING TOOLS 

let qty on hand = 



RESTARTS THE PROGRAM OF THE IMMEDIATELY PREVIOUS LEVEL AT 
THE INTERRUPT POINT 



1 USAGE: start 



V 



/ sr; 



EXAMPLE: WHILE IN qedx, THE USER SIGNALS QUIT WHILE DOING A 
1,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES start 
AND THE 1,$p CONTINUES 
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EXECUTING AH OBJECt PROGRAM 



Q program_interrupt , pi 

D RESTARTS THE PROGRAM AT A PROGRAMMER DETERMINED POINT 



PROGRAM MUST HAVE BEEN WRITTEN WITH A program_interrupt 
HANDLER 




USAGE: program_interrupt 
pi 



EXAMPLE: WHILE IN qedx, THE USER SIGNALS QUIT WHILE DOING A 
1,$p. AFTER RECEIVING A READY MESSAGE THE USER TYPES pi, 
AND FINDS HIMSELF BACK IN THE EDITOR AT REQUEST LEVEL 



release, rl 



D RELEASES THE IMMEDIATELY PREVIOUS LEVEL (S) (ONE OR ALL) 

Q USAGE: release {-control_arg} 
rl 
rl -all 
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• DEBUGGING TOOLS 



I SUBSYSTEMS WHICH ARE USEFUL IN LOCATING, EXAMINING, AND 
CORRECTING UNEXPECTED OCCURRENCES OR CONDITIONS WITHIN OBJECT 
PROGRAMS 



SUCH TOOLS MINIMIZE THE NEED FOR MEMORY DUMPS 



• debug, db 



D INVOKES AN INTERACTIVE DEBUGGING AID 



D HARDWARE LEVEL, SYMBOLIC, CRYPTIC 



PROCEDURES MAY HAVE ORIGINATED FROM ANY LANGUAGE. (SYMBOLIC 
CAPABILITY ONLY AVAILABLE FOR PL/I AND FORTRAN) 



IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 



D USES A HOME DIRECTORY SEGMENT NAMED Person_id .breaks 

USAGE: debug 
db 
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DEBUGGING TOOLS 



probe, pb 



INVOKES AN INTERACTIVE DEBUGGING AID 



SYMBOLIC, SOURCE LEVEL 



PROCEDURES MUST HAVE ORIGINATED FROM PL/I, FORTRAN, OR COBOL 
SOURCE 



IN ORDER TO UTILIZE SYMBOLIC CAPABILITIES, THE SOURCE PROGRAM 
MUST HAVE BEEN COMPILED WITH THE -table CONTROL ARGUMENT 



USAGE 1; probe path 
(SETTING) 



USAGE 2: probe 
(EXAMINING) 



fl A THOROUGH DISCUSSION OF THE probe COMMAND MAY BE FOUND IN THE 
COMMANDS AND ACTIVE FUNCTIONS MANUAL AG92 
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DEBUGGING TOOLS 



DEBUG 
CAPABILITIES 



PROBE 
CAPABILITIES 



EXAMINE DATA, SOURCE AND OBJECT 
MODIFY DATA AND OBJECT 
EXECUTE COMMANDS 
CONDITIONAL BREAK POINTS 

EXAMINE MACHINE CONDITIONS 

EXAMINE REGISTERS 

DUMP DATA IN VARIOUS FORMATS 



EXAMINE DATA AND SOURCE 

MODIFY DATA 

EXECUTE COMMANDS 

CONDITIONAL BREAK POINTS 
AND/OR OPERATIONS 
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• RECALL: 



a COMMAND PROCEDURE 

A PROGRAM INVOKED BY TYPING ITS NAME 

D OBJECT PROGRAM 

EXECUTED BY TYPING ITS NAME 



• COMMAND LINE INTERPRETATION 

B THE FIRST WORD OF EVERY COMMAND IS ASSUMED TO BE THE NAME OF AN 
OBJECT PROGRAM 

list -all 

Is 

send^message Student_05.F01 Where are you? 
add 



MULTICS SEARCHES THROUGH VARIOUS (PREDETERMINED) DIRECTORIES TO 
FIND AN OBJECT SEGMENT HAVING THE SPECIFIED NAME 



IF THE SEARCHING IS SUCCESSFUL, LINKING OCCURS ("THE LINK IS 
SNAPPED") AND EXECUTION COMMENCES 
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DYNAMIC SEARCHING 



ALL COMMANDS (SYSTEM PROGRAMS), USER-WRITTEN PROGRAMS, AND 
SUBROUTINE MUST BE "FOUND" BEFORE THEY CAN BE EXECUTED 



/; 



n 



n 



4^ 



SEARCH RULES (WHERE, C)^» WHERE) 



A LIST SPECIFYING THE NAMES AND THE ORDER OF DIRECTORIES TO BE 
SEARCHED 



SEARCH RULES ONLY HAVE SIGNIFICANCE FOR THE EXECUTION OF OBJECT 
PROGRAMS. COMMANDS SUCH AS list AND print DO NOT SEARCH FOR 
THEIR "TARGETS" 



I f/lo DEFAULT SEARCH RULES 




^/X £r^J^- 



Jc"^ 









- initiated segments 


referencing directory 


_ working 


directory 


>system 


library standard 


>system 


library unbundled 


>system 


library 1 


>system 


library tools 


>system 


library auth maint 
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SEARCH RULES EXAMPLE FOR USER JONES 



Jones 



.working 
directory 






call R; 



o 
I 

ro 






^^■■'^■■'iMi 



call T; 



o 



Jones' TERMINAL INPUT 


COMMAND LINE TYPKD 


SEGMENTS FOUND 


login Jones 
password 


/•|oginRELATED-\^^>'^ 
V SEGMENTS J^ ' 


pwd 


> sss > pwd 


S 


> udd > . . . > Jones > S 

> udd > . . . > Jones > T 


> udd > . . . > Smith > XYZ 


> udd > . . . > Smith > XYZ 

> udd > . . . > Smith > R 


XYZ 


> udd> . . . > Smith > XYZ 

> udd > . . . > Smith > R 


ABC 


> udd > . . . > Jones > ABC 

> udd > . . . > Smith > R 


pr > Udd > . . . > Smith > R.pll 
pr R.pll 


> sss > pr 

> sss > pr 




— ' 




X 



Smith 



] 



CD <S> 



Jones' INITIATED SEGMENT LIST 



> 

n 
o 

00 

m 
> 
so 
o 

2C 

o 



SEGMENT INITIATED 



/"login RELATED '\ 
V SEGMENTS / 

> sss > pwd 

> Jones >S 

> Jones >T 

> Smith >XYZ 

> Smith > R 

> Jones >ABC 



> udd > , . 


> udd > , . 


> udd > . . 


> udd > . . 


> udd > . . 


> sss > pr 



DYNAMIC SEARCHING 




print__search__rules, psr 




<#ici/t^ 



J^^.^^ J^ --^^ 




PRINTS THE USER'S CURRENT SEARCH RULES 

fl USAGE: print_search_rules 
psr 



add_search__rules, asr 




D ADDS A DIRECTORY TO THE USER'S SEARCH RULES 

1 USAGE: add_search_rules pathi {-control_arg path2} 

asr >udd>F01>Student_01>tools -after working dir 



initiated segments 


referencing directory 


working 


directory 


>udd>F01>Student 01>tools | 


>systera 


library standard 


>system 


library unbundled 


>system 


library 1 


>system 


library tools 


>system_ 


_library_auth_maint 
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DYNAMIC SEARCHING 



delete search rules, dsr (^ J^^r^'^^' cj^^'r 



fl DELETES ONE OR MORE DIRECTOBlll FROM THE USER'S SEARCH RULES 

fl USAGE: delete_search__rules paths 

dsr >udd>F01>Student 06>tools 



initiate, in 



D ENABLES USERS TO INITIATE (MAKE KNOWN) SEGMENTS DIRECTLY 



THE SEGMENTS REFERENCE NAME AND ITS ABSOLUT^ PATHNAME ARF 
PLACED IN THE USER'S LIST OF INITIATED SEGMENTS ^^^ "^^^^ ^^^ 



USAGE: initiate path {ref__names} {-control_args} 
in >udd>FED>Kerr>tools>editor 
in >udd>FED>Kerr>tools>editor qx 
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DYNAMIC SEARCHING 



list__ref_names, Irn ( /^,^^^J^ ^ 

D LISTS THE REFERENCE NAME, PATHNAME AND SEGMENT NUMBER OF 
SEGMENTS KNOWN TO THE USER'S PROCESS (I.E. INITIATED SEGMENTS) 



fl USAGE: list_ref__names {paths} {-control_args) 
Irn 
Irn >udd>F01>Student 07>add 



• terminate ref name, tmr 



D ALLOWS THE USER TO REMOVE A SEGMENT FROM THE LIST OF SEGMENTS 
KNOWN TO HIS PROCESS (I.E. INITIATED SEGMENTS) 



Q USAGE: terminate__ref__name ref__names 
tmr add who 
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DYNAMIC SEARCHING 



where, wh ( . . . HOW I WONDER WHERE YOU ARE!) 



° PAT^H^NASf ri sSt" """^ '' '''''' ''' '^'^^ ^HE ABSOLUTE 



ONLY THE PRIMARY NAME OF THE LOCATED SEGMENT IS PR 



INTED 



MAY BE USED TO CHECK IF A NAME IS "SAFE" TO USE FOR A SEGMENT 



II USAGE: 



where ref_name {-control__arg} 

wh qx 

wh sort 

wh wh -all 

wh >udcl>F01>Student_06>add.pl1 



EXEC^?ETpRSGRAMS^'r'Hfs' HOME dS^.^ '^'^^^^^ '' ^ ''^^'^^ ^^D 
RULES OR INinA^ED SEGMENTS IS REqSiRED^ ' '' KNOWLEDGE OF SEARCH 



YOU ARE NOW READY FOR WORKSHOP 
#5 
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TOPIC XI 



ACCESS CONTROL 



What is Access Control . . . . 
Access Control List (ACL) . . . 
Access Manipulation Commands 
Default and Initial ACL Entries 
Access Examples ........ 
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WHAT IS ACCESS CONTROL 



ACCESS CONTROL 

i A FACILITY FOR CONTROLLING (IN A SELECTIVE MANNER) 

D ACCESS TO THE CONTENTS OF SEGMENTS 

D ACCESS TO THE ATTRIBUTES OF SEGMENTS 

ABILITY TO CREATE SEGMENTS 

ABILITY TO DELETE SEGMENTS 



' IndIIt^' ^I^h''o?^^S UsL'f '' SELECTIVELY SHARE THEIR PROGRAMS 



II USER MUST EXPLICITLY GRANT (SET) ACCESS IF SHARING IS DESIRED 
set_acl, delete^acl & list__acl COMMANDS 

D SELECTIVE SHARING 
fl BY Person__id 
fi BY Project__id 
II BY ACCESS MODE (READ, WRITE ...) 
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ACCESS CONTROL LIST (ACL) 



ACCESS CONTROL LIST (ACL) 



EVERY SEGMENT AND DIRECTORY HAS ITS OWN ACCESS CONTROL LIST 
(ACL) 



AN ACL IS A LIST OF User_ids-LIKE ENTRIES CALLED ACCESS 
IDENTIFIERS, AND ASSOCIATED ACCESS MODES 



r 


TSrnith.ProjA.* 


rvi 


Student_on.F01.« 


r 


«.FED.« 



D IN ORDER FOR A USER TO ACCESS A SEGMENT (OR DIRECTORY): 



D THE USER'S User id MUST "MATCH" AN ENTRY ON THE ACL 



FURTHERMORE, THE USER IS RESTRICTED TO THE ACCESS MODE(S) 
SPECIFIED BY THAT PARTICULAR ACL ENTRY 



BY DEFAULT, USERS ARE GIVEN COMPLETE ACCESS TO THE SEGMENTS AND 
DIRECTORIES THEY CREATE 



USERS MAY ADD AND DELETE ENTRIES FROM THE ACL'S OF THEIR 
SEGMENTS AND DIRECTORIES VIA THE set_acl AND delete_acl 
COMMANDS 
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ACCESS CONTROL LIST (ACL) 



AN ACL IS CONSIDERED AN ATTRIBUTE OF A SEGMENT OR DIRECTORY 
IN ORDER TO set acl OR delete acl. THF n^RR mfiqt uauc tut? 
APPROPRIATE PERMISSION TO DO SO ~ ^"^ 



iSfORMED^^^^^^^^^ ^^^ ^^^^^^^ ^^ ^"^ ^^^^^^ A^^ THE VIOLATOR IS 



ACCESS CHANGES OCCUR INSTANTANEOUSLY SINCE ACCESS RTPHT^ arp 
CHECKED BY HARDWARE WITH EVERY ACCESS ^^^ 
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ACCESS CONTROL LIST (ACL) 



ACCESS MODES FOR SEGMENTS (rew n) 



CONTENTS OF THE SEGMENT CAN BE READ BY THE DESIGNATED 
USER(S) 



print, copy, move, qedx*s "r" request 




) ^,/ir*^^ ^'if^-v^^ 



d<^ 



fhg-t<-<^ 



I CONTENTS OF THE 5EUMENT UAN tit tXtUUItU tJI THt ULi>iUNAlt.U 
USER(S). (MFA^TMnFllT. ONLY FOR OBJECT SEGMENTS ) 

DEPENDING ON THE OBJECT PROGRAM, READ MAY ALSO BE REQUIRED 
FOR EXECUTION 



II add, >udd>F01>Student 01>add 



CONTENTS OF THE SEGMENT CAN BE MODIFIED (OVER WRITTEN) BY 
THE DESIGNATED USER(S) 






D qedx's "w" request 



fl NULL (n) 




a-yC^^^^^^^ 



(UrM- 



ALL ACCESS TO THE CONTENTS OF THE SEGMENT IS EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 
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ACCESS CONTROL LIST (ACL) 



/ 




ACCJ ^S MODES FOR DIRECTQ I?!^-^ _ r«ma n) DO NOT INFLUENCE ACCESS ON 

INFERIOR DIRECTORIES 




D ^HHSHFg °f EXISTING ENTRIES IN THE DIRECTORY CAN BE 
OBTAINED BY THE DESIGNATED USER(S) 



fl status, list 



MODIFY (m) J 



y^ 




ATTRIBUTES OF EXISTING ENTRIES IN THE DIRECTORY CAN BE 
MODIFIED BY THE DESIGNATED USER(S). 

ENTRIES CAN ALSO BE DELETED BY THE DESIGNATED USER(S) 
add_name, rename, delete, set_acl, delete_acl 

-\r^ 

APPEND (a) ) 



NEW SEGMENTS, DIRECTORIES, AND LINKS CAN BE CREATED IN (OR 
MOVED TO) THE DIRECTORY BY THE DESIGNATED USER(S) 







^ 



I/' 



IM 



create, create_dir, link, copy, move 




NULL (n) 



D ALL ACCESS TO THE ATTRIBUTES OF EXISTING ENTRIES IN THE 
DIRECTORY IS EXPLICITLY DENIED FOR THE DESIGNATED USER(S) 
-AND- THE CREATION OF ENTRIES IN THE DIRECTORY IS EXPLICITLY 
DENIED FOR THE DESIGNATED USER(S) 
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ACCESS CONTROL LIST (ACL) 



ACCESS IDENTIFIERS 

II THREE-COMPONENT CHARACTER STRING 

Q TAG IDENTIFIES THE TYPE OF PROCESS 

II a - AN INTERACTIVE PROCESS (A REAL USER) 

D m - AN ABSENTEE PROCESS (AN »'ABSENT" USER) 

z - A SYSTEM PROCESS (A DAEMON) LOGGED IN BY THE OPERATOR 

D MULTICS ASSIGNS EVERY USER AN ACCESS IDENTIFIER AT LOG IN 



D WHEN USED IN AN ACCESS CONTROL LIST, ACCESS IDENTIFIERS ARE 
OFTEN CALLED "ACL ENTRIES" 



JLF--A~CQM£jQli£HX-i3El-^^AE--A ^ IS A STAR (ASTERI SK). THE ST AR 

>^S,aNTERPRETED AS MATCHING ANY Person^id ,~^ffFrTroject_id ,~0R 
ANYtag7~TC7EtrDING ON ITS POSITION IN THE ACCESS IDENTIFIER 



*.F01.a MATCHES ALL INTERACTIVE F01 USERS 



Student_09.*.* MATCHES Student_09 REGARDLESS OF 

HOW HE LOGS IN 



*.».m MATCHES ALL ABSENTEE USERS 

».».» MATCHES EVERYONE 
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ACCESS CONTROL LIST (ACL) 




o 



-4^^^IFTrf5fimffii^;L T ''''' ''' -^UimmCALyi^ORDERE^^MOST 



Frommer.FOI .a 

Frommer.FOI .* 

Frommer .*.a 

Frommer .*.* 

*.F01 .a 

».F01.» 

».«.a 
« « « 



• MATCHING User__id WITH ENTRIES ON AN ACL 



D PROCEEDS FROM TOP TO BOTTOM 



fl FIRST MATCH DETERMINES ACCESS MODE(S) 



D NO MATCH IMPLIES NO ACCESS 
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ACCESS CONTROL LIST (ACL) 



EXAMPLE: LET seg_1 HAVE THE FOLLOWING ACCESS CONTROL LIST 



seg__1 's ACL 



rew 


LJones.FED.a 


rw 


Student 07.F01.* 


r 


TSmith.ProjA.» 


rew 


White. *.» 


rw 


».ProjA.» 


n 


».FED.« 


rw 


*.SysDaemon.* 


n 


».».m 


r 


*,* .* 



USER 

LJones.FED.a 

LJones.FED.m 

TSmith.ProjA.a 

TSmith.FED.a 

\jrc6n . irojA • a 

White.ProjA.a 

White. FED. a 

LJones.Fd .m 

LJones.FED.m 

Kerr .MAC. a 



USER'S ACCESS 
rew 
n 
r 
n 
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ACCESS MANIPULATION COMMANDS 



V ^? V G W ^ a O GL 




ytCfS^'^*' 




Q MANIPULATES THE ACL»S OF SEGMENTS AND DIRECTORIES 



r^ 



.ypA*-*"^ 



, ,,- 'V - V, , -_.,_,. „. 

USAGE: (set_ac]/patl^ (mocie2){pser_id2.. .^ .modi§ User_idn^ 
sa add.pH rw Student__04 .F01 .» 
sa add.pll r »;F01.« rw ».FED.» 
sa *.pl1 r LJones.*.* 
sa dir A sma LJones. FED.* 



»« r « « « 




• delete_acl, da 

D REMOVES ENTRIES FROM ACL »S OF SEGMENTS AND DIRECTORIES 

D USAGE: delete__acl {path {User__ids}} 
da add.pll ».F01.» 
da add.pll Student_04.F01 .* ».FED.« 
da dir A LJones. FED.* 
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ACCESS MANIPULATION COMMANDS 




list acl, la 



D LISTS THE ACL»S OF SEGMENTS AND DIRECTORIES 



11 IF path OMITTED THEN NO User_id POSSIBLE 

D USAGE: list_acl {path {User__ids}} 
la add.pH 

la add.pll LJones.FED.» 
la 
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DEFAULT AND INITIAL ACL ENTRIES 



WHEN SEGMENTS AND DIRECTORIES ARE CREATED AN AGL T«^ ArirnM/iTTr at r v 
PROVIDED BY MULTICS CONTAINING DFFAFIT T ar/ ^mtdtcc"^^ AUTOMATICALLY 



CONTAINING DEFAULT ACL ENTRIES 



D FOR MOST SEGMENTS: 



rw 
rw 



Per son__icl. Project id.* 
*.SysDaeraon.* 



D FOR DIRECTORIES: 



sma 
sroa 



Person__id . Pro ject^id . * 
*.SysDaeinon.« 



NORMAL ACCESS GIVEN TO SYSTEM DIRECTORIES: 



D A USER IS GIVEN "sma" ON HIS HOME DIRECTORY 



D A USER IS GIVEN "s" ON HIS PROJECT DIRECTORY 



A PROJECT ADMINISTRATOR IS GIVEN "sma" ON THE PROJECT DIRECTOR 



D THE SYSTEM »S ADMINISTRATOR HAS "sma" ON >udd 
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DEFAULT AND INITIAL ACL ENTRIES 



INITIAL ACCESS CONTROL LIST 



B A FACILITY FOR DEFINING ADDITIONAL DEFAULT ACL ENTRIES TO BE 
INCLUDED IN THE ACL OF SEGMENTS AND DIRECTORIES WHEN CREATED 



fl DEFINABLE AT THE DIRECTORY LEVEL 



D REFER TO THE DESCRIPTION OF THE FOLLOWING COMMANDS IN THE 
MULTICS COMMANDS MANUAL 

set_iacl_seg, sis set_iacl__dir , sid 
list_iacl_seg, lis list_iacl__dir , lid 
delete iacl seg, dis delete_iacl__dir , did 
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ACCESS EXAMPLE FOR STUDENT«02 



udd 



F01 



Student .01 



sma 



Student.02 



sa 



Dir-1 







Dir.2 



sma 



rw 



Dir.3 



O 



Dir.4 



r n re w 



re 



rw 



© © © © 
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ACCESS EXAMPLES 



IN WHICH DIRECTORIES CAN Student__02 SUCCESSFULLY EXECUTE THE list 
COMMAND? 



• IN WHICH DIRECTORIES CAN Student 02 CREATE A SEGMENT? 



• SUPPOSE Student_02 CREATES A SEGMENT IN DIRECTORY Dir_1 BY TYPING 
create >udd>F01 >Student_01 >Dir__1 >Z 

CAN Student_02 DELETE THIS SEGMENT? "^'^^ ". ^^'^^^^ ^y 

CAN Student__02 rename THIS SEGMENT? .'^^.^^ ^/ 

CAN Student_02 READ AND WRITE THE CONTENTS OF THIS SEGMENT? W-^^ 



• IN WHICH DIRECTORIES CAN Student_02 SUCCESSFULLY EXECUTE THE 
rename COMMAND? _/; - , 



• IN WHICH DIRECTORY CAN Student 02 SUCCESSFULLY EXECUTE THE set acl 
COMMAND? 
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ACCESS EXAMPLES 



TO WHICH SEGMENTS CAN Student 02 WRITE? 



Pif 



/ 

TO WHICH SEGMENTS COULD Student 02 EVENTUALLY WRITE BY SETTING THE 
APPROPRIATE ACCESS? 



^;^,^^^$t^ ^Tt/^^ 



• SUPPOSE Student_02 CREATES A DIRECTORY UNDER Dir__1 BY TYPING 
create_dir >udd>F01>Student__01>Dir_1>Dir_5 

WHAT PERMISSIONS WILL Student_02 HAVE ON THIS DIRECTORY? S/iA 
WHAT PERMISSIONS WILL Student__01 HAVE ON THIS DIRECTORY? n 
CAN Student_01 GIVE HIMSELF PERMISSIONS ON Dir_5? /xpz^d^ 



y / 
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TOPIC XII 
USER COMMUNICATION 



Page 

Message Facility ip -, 

Mail Facility l. '.'.'.]]' ' ^'n 

Memo Facility ' ] 12..5 
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MESSAGE FACILITY 








" COMMAND^'^" ^^ COMMUNICATED BETWEEN USERS VIA THE send 



_message 




° Sam^ ?ffLnM";^bx"'''°" >uda>ProJa=t_id>Person_id HAVING THE 




accept__messages, am) (I^M LISTENING) 



" n^pp'ff T^^LS'? ^^^ ^^^°^^NG MESSAGES TO BE PRINTED ON THE 



USER'S TERMINAL 



D OTHERWISE, MESSAGE WILL GO TO THE USER'S MAILBOX 



fl ALSO CREATES A MAILBOX IF NONE EXISTS 



I USAGE: 



aceept_messages {-control_args} 
am 



am -print 
am -brief 
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MESSAGE FACILITY 




send message, sm 



Q SENDS A MESSAGE TO A SPECIFIED USER ON A SPECIFIED PROJECT 

D SMALL MESSAGES (ONE LINE) 

D MESSAGES ARE EITHER 

D PRINTED ON THE RECIPIENTS TERMINAL, OR 
I PLACED IN THE RECIPIENTS MAILBOX 

fl USAGE 1: send_message Person_id .Project_id message 

sm TSmith.Project_id When are you going to lunch? 
sm Greenberg.FED May I have access to your file? 



USAGE 2: send message Person_id. Project 
(DIALOGUE M0DE7 

sm TSmith.FED 

Input: 

When are you going to lunch? 

From TSmith.FED 11/10/78 1546.3 mst Fri: 12:00 

Mary wants to go with us. 

=:Fine, bring her along. 

Meet you in the lobby. 
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• defer_messages, dm /(I'M BUSY. .NO DISTRACTIONS WANTED) 



D REDIRECTS ANY AND ALL INCOMING MESSAGES TO THE USER'S MAILBOX 

fl ELIMINATES UNWANTED INTERRUPTIONS 

D USAGE: defer_messages 
dm 




D PRINTS ALL MESSAGES STORED IN THE USER'S MAILBOX 

D MESSAGES ARE DELETED FROM THE MAILBOX WHEN PRINTED 

Q USAGE: print__messages {-control_arg} 
pm 

pro -last 
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MAIL FAGILItY 



• MAIL 




c^ 



:££3«^4W-iCii--ia^MMUNICATED BETWEEN USERS VIA THE mail COMMAND 



«a<tf-/asi-' 




PRINTS ANY AND ALL MAIL (OR MESSAGES) IN A USER'S MAILBOX, OR 



pi stNDS THt uontknts Of a segment to another user 




D WHEN SENDING, MAIL IS PLACED IN THE RECIPIENT'S MAILBOX 

fl USAGE 1; mail {path} {-control arg} 
(PRINTING) 

ml 

ml -bf 

ml >udd>F01 >Student_04>Student_04 .mbx 

1 ALSO CREATES A RING-PROTECTED MAILBOX IF NONE EXISTS 

USAGE 2: mail patH User ids {-control arg} 
(SENDING) \^ ~ •" 

mail fw16. report LJones.FED 

mail letter Student_05.F01 -ack 

mail S__letter* runout TSmith.ProjA Boyd. Pro j A 
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MAIL FACILITY 







USAGE 3» roail/*/Us6r ids 
(SENDING) ^ 



mail » L Jones. FED TSmith,ProiA 
Input: 

The finance committee will begin meeting 
on^Tuesdays at 3:30 starting 

Coffee will be provided. 





RELATED COMMANDS 

mbx_create, mbcr 
mbx__delete, mbdl 
rabx__add_name, mban 
mbx_delete__name, mbdn 
mbx_rename, mbrn 
mbx_set_acl, mbsa 
rabx_delete_acl, mbda 
mbx__list_acl, mbla 
mbx_set_max_length, mbsml 
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MEMO FACILITY 



MEMO FACILITY 



AN INTERACTIVE NOTEBOOK AND REMINDER LIST 



D <^AINTAINEJ ^ BY T HE OISER^ N A HOME DIRECTORY SEGMENT NAMED 
^rson id. memo 



• MEMO 



A MESSAGE DELIVERED TO THE USER AT A PREDETERMINED DATE AND 
TIME, OR 



A COMMAND EXECUTED BY THE SYSTEM AT A PREDETERMINED DATE AND 
TIME 



11 MATURE MEMOS MAY BE ACTIVATED 



1 EXPLICITLY (VIA THE memo COMMAND), OR 



E AUTOMATICALLY (WHILE USER IS LOGGED IN) 



MEMOS OPERATE INDEPENDENT OF THE accept_messages/defer_messages 
COMMANDS 
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MEMO FACILITY 




CREATES AND MAINTAINS AN INTERACTIVE NOTEBOOK AND REMINDER LIST 



fl USAGE 1: memo 
(EXECUTING) 



memo 



USAGE 2: memo -list {optional arcs) 
(LISTING) - «i ' 

memo -list 

memo -list -match Birthday 

^ ^^l^^Ur. ^^^° {optional__args} memo text 
(SETTING) - 

memo Good job Tom!!! Keep up the good work! 
memo -time "Friday Sam est" 10am meeting with Olson 
memo -date 5/6/78 -repeat lyear Jan's Birthday:May 9 
memo -call -tm Friday sm May ProjA Report due today. 
memo -alarm -repeat Iday -time noon Lunch time! 



USAGE 4: memo -delete optional arcs 
(DELETING) - 

memo -delete -match Birthday 
memo -delete -call 
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TOPIC XIII 
MULTICS INPUT/OUTPUT FACILITIES 



Page 

Multics Input/Output ,^ , 

System Input/Output Modules . . ' ' * ' • • • J 3-1 

Input/Output Switches li'f, 

Input/Output Commands ......*.'; Ir.n 

Examples • • • 13-10 

13-15 
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MULTICS INPUT/OUTPUT 



LOGICAL I/O 



• DEVICE INDEPENDENT 



SYSTEM I/O MODULES CONTROL THE PHYSICAL DEVICES 



S^ORlG^riSS'^EVI^C^I^'^rr^?.' '''' '' ''^^ ^^^^^^N PROGRAM ACCESSIBLE 



DEVICES, FILES, ETC 
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SYSTEM INPUT/OUTPUT MODULES 



SYSTEM INPUT/OUTPUT MODULES 

D THE Multics SYSTEM CONTAINS THE FOLLOWING I/O MODULES: 

discard_ 

IS A SINK FOR UNWANTED OUTPUT 

D rdisk__ 

SUPPORTS I/O FROM/TO REMOVABLE DISK PACKS 

1 record__streara_ 

PROVIDES A MECHAiJISM FOR DOING RECORD I/O ON AN UNSTRUCTURED 
FILE, OR VICE VERSA 

I syn_ 

ESTABLISHES ONE SWITCH AS A SYNONYM FOR ANOTHER 

tape_ansi_ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS PROPOSED BY THE AMERICAN NATIONAL STANDARDS 
INSTITUTE (ANSI) 

fl tape_ibra__ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES ACCORDING TO 
STANDARDS ESTABLISHED BY IBM 

1 tape_mult__ 

SUPPORTS I/O FROM/TO MAGNETIC TAPE FILES IN Multics STANDARD 
TAPE FORMAT 
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SYSTEM INPUT/OUTPUT MODULES 



I tty_ 

SUPPORTS I/O FROM/TO TERMINALS 

vfile__ ^ 

SUPPORTS I/O FROM/TO FILES IN THE STORAGE SYSTEM 

II THESE MODULES ARE DESCRIBED TN ^^rrrrnM ttt ^r, 

SUBROUTINES AND IN THE MpS'peRIPHeLl'iSpJ?/0UTp5t '' '"' ''' 

D the user may construct his own I/O SY<^TRM TMTCDcn^tr M^r>..r 
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INPUT/OUTPUT SWITCHES 



SOFTWARE CONSTRUCT WHICH MAKES I/O DEVICE INDEPENDENT 



v^uni^cv^rb irixL oOuRot ur a Rc.Al» u« wnUL Tu IttJt. lAKUtl ^MLt, TAPE, 
ETC.) THROUGH A SYSTEM I/O MODULE 





^t0mmm0m0^0mmm 



PROGRAM 



] 




I discard..] 
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INPUT/DUTPUT SWITCHES 



• TO PERFORM I/O, THE FOLLOWING FIVE STEPS MUST BE fARRTPn nrir 
(EITHER EXPLICITLY OR IMPLICITLY): tAHKIED OUT 

1) ATTACH AN I/O SWITCH. THIS STEP SPECIFIES THF qrrMRNT 
PATHNAME, TAPE VOLUME NAME, ETC FROM/TO WHIC^^^^ 

Je^^'orS^ ?H^0?El5^?;^2^''../^ ''' ^"^ ?/S MODULe'^WhIcH 
i'tRFORMS THE OPERATION (vfile_, tape_ansi_, etc.) 

2) OP||_THEI/0^ SWITCH. THIS STEP PREPARES THE SWITCH FOR A 
^FO^pSTTMrv^^?^?M.^L PROCESSING (E.G. READING RECORDS 
SEQUENTIALLY) USING THE ALREADY ESTABLISHED ATTACHMENT 

3) PERFORM THE REQUIRED DATA TRANSFER WORKING THROUGH THE SWITCH 
^^ CLOSE THE I/O SWITCH 

5) DETACH THE I/O SWITCH 



• SWITCHES MAY BE ATTACHED BY 



II io call COMMAND 



D SUBROUTINE CALL TO iox $attach ion 



ame 



D LANGUAGE OPEN STATEMENT (IF NOT PREVIOUSLY ATTACHED) 



DEFAULT WHEN RUNNING FORTRAN, PL/1, AND COBOL 
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INPUT/OUTPUT SWltCHES 



SWITCHES MAY BE OPENED BY 

D io_call COMMAND 

D SUBROUTINE CALL TO iox_$open LANGUAGE 

II LANGUAGE OPEN STATEMENTS 

11 DEFAULT WHEN RUNNING FORTRAN, PL/1, AND COBOL 



• DATA TRANSFER MAY BE PERFORMED BY: 

io_call COMMAND 

D SUBROUTINE CALL TO iox__, ioa_ 

D get, put, read, write, etc. in PL/1 

fl read, write, etc. in FORTRAN 

fl read, write, etc. in COBOL 

11 I/O STATEMENTS IN OTHER LANGUAGES 



13-6 



FO 



INPUT/OUTPUT SWITCHES 



• THE I/O SWITCH MAY 3E CLOSED BY: 



I io call COMMAND 



LANGUAGE close STATEMENT (IF THE SWITCH WAS OPENED BY A 
LANGUAGE OPEN STATEMENT 



D close file COMMAND 



• THE I/O SWITCH MAY BE DETACHED BY 



D io call COMMAND 



B SUBROUTINE CALL TO iox $detach iocb 



LANGUAGE close STATEMENT (IF THE SWITCH WERE ATTACHED BY THE 
LANGUAGE open STATEMENT) 
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INPUT/OUTPUT SWITCHES 



FOUR SWITCHES ATTACHED DURING PROCESS CREATION (login, new_proc) 
fl user__i/o 
fl user_input 
user__output 
error_output 



• nn?unn''2^Po ATTACHED TO THE USER'S TERMINAL THROUGH tty AN. 
OPENED FOR STREAM INPUT AND OUTPUT - 



user__input, user_output, and error output ARE ATTACHED TO 
user_i/o THROUGH syn AND ARE OPENED FOR INPUT, OUTPUT AND OUTPUT 
RESPECTIVELY ~ ' nnuuv.rKji 



13-8 FOl 



INPUT/OUTPUT SWITCHES 




STANDARD ATTACHMENTS 
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INPUT/OUTPUT COMMANDS 



io_call, io 



D PERFORMS AN OPERATION ON A DESIGNATED I/O SWITCH 



fl USAGE: io_call opname switchname {args} 

io attach payroll_tape tape_ansi_ payrol 
-cr -nm employee rec 
-nb 1 -retain all 

io attach poem vfile__ >udcl>F01>Student_02>The_Ra>^in 
io open poem stream_input 

*w (5%;w XX lie: ^UCIIJ 

io close poem 
io detach poem 



close__file, cf 

D CLOSES SPECIFIED FORTRAN AND PL/1 FILES 

D USAGE: close__file {-control_arg} filenames 
close_file poem fileOS 
close file -all 



13-10 P01 



INPUT/OUTPUT COMMANDS 



• print__attach_table, pat 



D- PRINTS INFORMATION ON THE USER'S TERMINAL ABOUT I/O SWITCH 
ATTACHMENTS 



I USAGE: print_attach_table {-control_args} {switch_naraes} 
pat 
pat poem 



• file_output, fo 



DIRECTS ALL SUBSEQUENT USER'S OUTPUT (TERMINAL OUTPUT) TO A 
SEGMENT UNTIL THE revert___output COMMAND IS ENCOUNTERED 



ATTACHES user_output TO A SPECIFIED OUTPUT FILE 



D ERROR MESSAGES (IF THEY OCCUR) STILL APPEAR ON THE USER'S 
TERMINAL 



I USAGE: file_output {path} 
fo who_save 
fo 
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INPUT/OUTPUT COMMANDS 



revert_output, ro 

D RESTORES USER»S OUTPUT (TERMINAL OUTPUT) TO THE TERMINAL 

B USAGE: revert_output 
ro 
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INt>UT/OUTPUT COMMANDS 




I TERMINAL i 



I user_outpui | 

W 



my_file 



file_output my_file 
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INPUT/OUTPUT COMMANDS 



copy file, cpf 



D COPIES RECORDS FROM A STRUCTURED INPUT FILE TO AN OUTPUT FILE 



USAGE: copy_file in_ctrl__arg out__ctrl_arg {-control__args} 

cpf -input_description "vfile__ >udd>F01>Student_01>funky" 
-output__switch funky_sw 

cpf -isw funky_sw -ods "tape_ansi foo -nm first_file -nb 1" 

cpf -ct 13 -ids "tape__ansi__ 887677 -nm TEST21 -ret all" 
-ods "record_3tream__ user__output" 



"T J 



copy cards 



COPIES SPECIFIED CARD IMAGE SEGMENTS FROM THE SYSTEM POOL 
STORAGE INTO A USER'S DIRECTORY 



D THE SEGMENTS TO BE COPIED MUST HAVE BEEN CREATED USING THE 
Multics CARD IMAGE FACILITY 



fl USAGE: copy_cards deck_name {pathname} 
copy__cards card__deck 
copy_cards card_deck my_file 
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• EXAMPLE 1 



" r?fr MAMc^oc^ ^^°" ^ ^^^^ ^^^" A VOLUME NAME OF payrol AND A 
FILE NAME OF emp 



READ THESE RECORDS ONE AT A TIME FROM COMMAND LEVEL 

! io attach pt tape_ansi_ payrol -name emp -nb 1 -ret all 
! io open payroll _tape sequential input 
I pat pt "" 

pt tape__ansi_ payrol -name emp -nb 1 -ret all sequential_input 
! io read pt 85 

io_call: 85 characters returned. 15093Robert Redford 5534 w. Yucca 

! io read pt 85 

io_call: End of information reached. No data returned by ot 
! 10 close pt ^ ^ 

! pat pt 

pt tape__ansi__ payrol -name emp -number 1 -retain all 

I V^ A^^^r^u 4. ^"°^ open) 

! 10 detach pt 



^ rSlll ^"^ ^^^^ RESOURCES WERE ALLOCATED PRIOR TO THE ATTACH 
OTHERWISE, A MESSAGE WHICH WOULD INDICATE THE TAPE WAS BEING 
MOUNTED WOULD HAVE BEEN RETURNED AFTER THE io attach 
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EXAMPLES 



EXAMPLE 2 



READ DATA FROM A FILE AND WRITE TO ANOTHER 



USING THE SAME PROGRAM, READ FROM A FILE AND WRITE TO THE 
TERMINAL. (USE io__call AND ATTACH THE OUTPUT SWITCH EXTERNAL 
TO THE PROGRAM) 



D THE PROGRAM: 

example__2: proc; 

del payroll_in file, 

yOJI UXX VWW i,XJL<C, 

sysprint file, 

1 emp__record, 

2 pay_no char (5) , 

2 emp, 

3 name char (20), 

3 address char (20), 

(endfile, record, transmit) condition; 

on endfile (payroll_in) go to fini; 

on record (payroll in) ; 

on transmit (payroTl^in) begin; 

put skip list 

(ft^R^jjSMIT ERROR. LAST RECORD READ WAS:", emp__record) ; 

go to fini; 
end; 

open file (payroll_in) 

title (»»vfile_ payroll file") input; 

open file (payroll_outT 

title ("vfile_ payroll_file_2") output; 

do while ("1"b); 

get file (payroll_in) list (erap_record) ; 

put file (payroll''out) skip list (erap__record) ; 
end; " 

fini: close file (payroll__in) , file (payroll_out) ; 
put skip list ("done"); 
end example 2; 
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EXAMPLES 



S INPUT FILE, payroll file: 

"12002", "Barbara Striesand", "4040 N. 30th lane" 

"15093"? "Robert Bedford", "5534 w Y^'cca" 

"15666", "Julie Christie", "3322 W.' Milky Way" 



SEQUENCE OF EXECUTION 
! example 2 



done 
1 pr payroll file 2 



payroll__file_2 11/09/78 1710.8 mst Thu 



"12002" "Barbara Striesand " »»4040 N. 30th Lan** 

"]i66^" ;;r?^^^.'^^^°^^ " "5534 iJ: Yucca 
"15666" "Julie Christie »» »»:?:i?p u m,- 1 1,,, 



ti 



" "3322 W. Milky Way " 



pat 



user-lnout ^'^- "^'^^^ ^*'-^^'» i^P"^ output 

user^input syn_ user i/o "" 

user_output syn user~i/o 

error^output syn__ user~i/o 

sysprint syn_ user__output 

I io attach payroll__out syn user output 
! pat payroll__out "" - *- 
payroll__out syn user output 
! example__2 "" - ^ 

"12002" "Barbara Striesand " "4040 N :?ni-h t =,n^ « 

"nUli: :f?^'"^«^^f°'-<' •• "5532 w! yucca " 
dine '"''" Christie " ^3322 W. Milky Way " 

I pat payroll_out 

payroll_out syn__ user__output 
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EXAMPLES 



YOU ARE NOW READY FOR WORKSHOP 
#6 
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EXAMPLE 3 



D READ A DECK OF CARDS INTO THE SYSTEM AND CREATE A SEGMENT IN 
YOUR WORKING DIRECTORY CONTAINING THE CARD IMAGES 



STEP 1: YOU MUST BE REGISTERED BY THE SYSTEM ADMINISTRATOR FOR 
CARD INPUT. YOU WILL RECEIVE A PASSWORD FOR YOUR CARD DECKS 



STEP 2: CREATE A SEGMENT IN YOUR HOME DIRECTORY CALLED 
card input. acs 



STEP 3: SET ACL ON THE SEGMENT TO "r" FOR <STATION ID> » » AN/: 
FOR Card Input . Daemon .» - ' 



STEP 4: PREPARE THE CARD DECK 

++DATA DECK_NAME PERSON_ID PROJECT ID 
++PASSWORD XXX ~ 

++FORMAT MCC LOWERCASE 
++INPUT 



STEP 5: SUBMIT THIS DECK TO THE OPERATOR. A MESSAGE WILL BE 
SENT TO YOU WHEN IT HAS BEEN READ 



STEP 6: EXECUTE THE COPY CARDS COMMAND 
copy cards deck name 
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TOPIC XIV 
MORE ABOUT THE ABBREV PROCESSOR 
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The do Command . , , ^u i 

Areas for Additional Study ...!!! [ [ [ [ [ \ \ \ \ \^Z\ 
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THE DO COMMAND 



m MOTIVATION: 

D WOULD LIKE TO BE ABLE TO DO THE FOLLOWING 
.ab PL1 ind; pll 
PLl add. pll 

D WHICH EXPANDS TO: 

ind; pll add. pll 



11 BUT WANT: 



ind add.pH; pll add.pH 



• do 



D SUBSTITUTES SUPPLIED ARGUMENTS INTO A COMMAND LINE 



fl PRIMARILY INTENDED FOR USE IN ABBREVIATIONS 



fl USAGE: do "command line" args 



do "ind &1; pll &i" add. pll 




do "ind &1; ind &2; ind &3" add. pll sub. pll mult.pH 
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THE DO COMMAND 



COMMAND LINE FLOW 

TYPED LINE 



i 



FRONT-END PROCESSOR 



U 



{ABBREV PROCESSOR} 



i 

iO( 

1 



COMMAND PROCESSOR -4 do COMMAND PROCEDURE 



EXECUTION 
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THE DO COMMAND 



EXAMPLES USING THE FOLLOWING ABBREVS: 



PL1 


do "ind &1; pll &1" 


PLI^DP 


do "PL1 &1; dp &1" 


PL1_EX 


do "ind &1.pl1; pll &1.pl1; &1" 



D EXAMPLE 1: 



PLIiadd.plI 



do "ind &1; pll &1»»l add.pH 
ind add. pll; pll add. pll 



(AS TYPED) 
(ABBREV PROCESSOR) 
(DO COMMAND) 



D EXAMPLE 2: 



PL1 EX. add 



do "ind &1.pl1; pll &1.pl1; &1"l add 
ind add. pll; pll add. pll; add 



(AS TYPED) 
(ABBREV PROCESSOR) 
(DO COMMAND) 
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THE DO COMMAND 



Q EXAMPLE 3: 

PLI^DP add.pll ' (AS TYPED) 

do "PL1 &1; dp &1"' add. pi 1 (ABBREV PROCESSOR) 

PL1 add.pH; dp add.pll <D0 COMMAND) 

do "ind &1; pl1 &1"'add.pl1; dp add.pll (ABBREV PROCESSOR) 

ind add.pH; pll add.pll; dp add.pH (DO COMMAND) 
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AREAS FOR ADDITIONAL STUDY 



ADDITIONAL DOCUMENTATION 

D MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 

help abbrev 



• STUDY TOPICS 

D ADDITIONAL abbrev REQUESTS 

D -u (USE ANOTHER PROFILE) 

^ -P (PRINT THE PATHNAME OF THE PROFILE BEING 

USED) 

D -af (FORCE REDEFINE) 

D -abf (FORCE REDEFINE) 

fl '^ (REMEMBER MODE) 

^ -^ (FORGET MODE - THE DEFAULT) 

D -s (SHOW LAST LINE) 
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TOPIC XV 
ACTIVE FUNCTIONS 



Page 

What is an Active Function .... ic - 

Active Function Mechanism .... * ' * ' ]^''l 
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Areas for Additional Study ... * * ' * 15 7 
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WHAT IS AN ACTIVE FUNCTION 



• ACTIVE STRING 

" yAR^-'L'ACys '^^^ COMMAND LINE DELIMITED (SET OFF) BY 

il INTENDED TO BE REPLACED BY A CORRESPONDING VALUE 

D EXAMPLES: 

sm Clast_message_sender] Thank you» 
sm LJones.ProjA Thank you! 

delete Coldest^segment] 
delete seg__1 

fl LIKE A DYNAMIC (OR VARIABLE) ABBREVIATION 

fl FREQUENTLY USED WITHIN ABBREVIATIONS 

D THERE ARE MORE THAN 70 ACTIVE STRINGS DEFINED BY MULTICS 
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WHAT IS AN ACTIVE FUNCTION 



• ACTIVE FUNCTION 



D A PROGRAM EXPLICITLY DESIGNED TO EVALUATE AND RETURN THE VALUE 
OF AN ACTIVE STRING 



D USERS MAY DEFINE THEIR OWN ACTIVE STRINGS AND WRITE THEIR OWN 
CORRESPONDING ACTIVE FUNCTIONS 



MANY ACTIVE FUNCTIONS MAY ALSO BE INVOKED AS COMMANDS 
last message sender 
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ACTIVE FUNCTION MECHANISM 



D ACTIVE STRINGS ARE IMMEDIATELY EVALUATED (EXECUTED) 



THE RESULTING VALUE IS SUBSTITUTED FOR THE ACTIVE STRING IN THE 
COMMAND LINE 



D THE COMMAND LINE IS THEN RETURNED TO THE COMMAND PROCESSOR 



• COMMAND LINE FLOW 

TYPED-LINE 



1 



FRONT-END PROCESSOR 



i 



{ABBREV PROCESSOR} 

♦- 






COMMAND PROCESSOR —> ACTIVE FUNCTION 

I 

EXECUTION 
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ACTIVE FUNCTION EXAMPLES 



• last_message_3ender , 1ms 



D RETURNS THE User^id OF THE SENDER WHO SENT THE LAST MESSAGE 
RECEIVED 



Q USAGE 1: last_message__sender 

1ms 
LJones.FED 



USAGE 2: [last_message__sender] 

sra [1ms] THANK YOU I 

sm LJones.FED THANK YOU! 

who [1ms] 

who LJones.FED 



wd 



D RETURNS THE PATHNAME OF THE USERS WORKING DIRECTORY 



D USAGE 1: wd 



wd 
>udd>FED>May 



D USAGE 2: [wd] 



sm Kerr. FED THE pathname is [wd]>add.pl1 

sm Kerr. FED THE pathname is >udd>FED>May>add.pl1 
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ACTIVE FUNCTION EXAMPLES 



date 



D RETURNS THE DATE IN mm/dd/yy FORM 



D USAGE 1: date {dt} 

date 
11/01/77 

date "12 June" 
06/12/78 



D USAGE 2: [date {dt}] 

create alpha.version__[date3 .pll 
create alpha. version__1 1/01/77. pll 



home dir 



RETURNS THE PATHNAME OF THE USERS HOME DIRECTORY 



D USAGE 1 : home_dir 

home__dir 
>udd>F01>Student 07 



I USAGE 2: Chome_dir] 

pr [horae_dir]>add.pl1 

pr >udd>F01>Student__07>add.pl1 
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ACTIVE FUNCTION EXAMPLES 



• segments, segs 



RETURNS THE ENTRYNAMES (SEPARATED BY A BLANK) OF ALL SEGMENTS 
MATCHING A GIVEN STARNAME 



USAGE: [segments starname] 

dprint [segs *«.pl1 ] 
dprint add.pll seg_1.pl1 



D RETURNS THE CONTENTS OF A SPECIFIED ASCII SEGMENT SEPARATED B 
BLANKS 



D USAGE: [contents path] 

sm TSmith.FED Their names are: [contents Names] 
sm TSmith.FED Their names are: LJones.FED Kerr. MED 

mail letter. 2 [contents Names] 
mail letter. 2 LJones.FED Kerr. MED 



15-6 poi 



AREAS FOR ADDITIONAL STUDY 



ADDITIONAL DOCUMENTATION 



D MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 



D help <active function name> 



• STUDY TOPICS 



II ARITHMETIC ACTIVE FUNCTIONS 



ceil, divide, floor, max, min, minus, mod, plus, quotient, 
times, trunc 



D CHARACTER STRING ACTIVE FUNCTIONS 

Q default, format__line, index, index_set, length, search, 
string, substr, underline, unique, verify 

D DATE AND TIME ACTIVE FUNCTIONS 

Q date, date__time, day, day_name, hour, long_date, minute, 
month, month_name, time, year 

D LOGICAL ACTIVE FUNCTIONS 



and, equal, exists, greater, less, nequal, ngreater, nless, 
not, or 
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li PATHNAME MANIPULATION ACTIVE FUNCTIONS 

/ siffix"''^' ^''^''^' equal_name, path, strip, strlp_entry, 

D QUESTION ASKING ACTIVE FUNCTIONS 
query, response 

STORAGE SYSTEM ATTRIBUTES ACTIVE FUNCTIONS 
Q Iv^attached, status 

D STORAGE SYSTEM NAMES ACTIVE FUNCTIONS 

D directories, files, get_pathname, home dir, links 
nondirectories, nonlinks, noniegments, pd, segments, wd 

D USER PARAMETER ACTIVE FUNCTIONS 

" ^«If-!f«h. last^message^sender, last message time, 
last__message, system, user "" ^ - "■ '^^ 
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MOKE ABOUT EXEC COM»S 
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REVIEW 



EXEC COM 

3 A SEGMENT CONTAINING A SERIES OF COMMAND LINES . 
D CREATED USING A TEXT EDITOR 
II NAME MUST HAVE SUFFIX OF ec 



D THE COMMAND LINES ARE EXECUTED SEQUENTIALLY, AS A SET. WHENEVER 
INVOKED BY THE USER 



B ABBREVIATIONS ARE EXPANDED IN THE NORMAL MANNER 



E MAY BE RECURSIVELY INVOKED 



• exec_com, ec 

D EXECUTES THE COMMAND LINES CONTAINED IN AN EXEC^COM SEGMENT 

ec A.ec 

ec weird. ec flower tree add 
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REVIEW 



• EXEC_COM LINE FLOW 

EXEC COM LINES 



i 






i 



COMMAND PROCESSOR 



i 



EXECUTION 
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ARGUMENT SUBSTITUTION 



ARGUMENT SUBSTITUTION 



11 CERTAIN CHARACTER STRINGS ARE REPLACED BY A CORRESPONDING VALUE 
BEFORE THE EXEC COM IS EXECUTED 



EXAMPLES USING EITHER OF THE FOLLOWING COMMAND LINES 

ec weird. ec flower tree add 

ec >udd>F01>Student_05>weird.ec flower tree add 

D &<number> 

D REPLACED BY THE CORRESPONDING OPTIONAL ARGUMENT 

(POSITIONAL) 

&1 4— flower 

&3 i — add 

&5 4~~<nothing> 

Q &n 

D REPLACED BY THE NUMBER OF ARGUMENTS SUPPLIED 
&n 4 — ^ 



II &ec__name 

REPLACED BY THE ENTRYNAME PORTION OF THE EXEC COM'S 
PATHNAME WITHOUT THE ec SUFFIX 



&ec__dir 

^ lEht^.E ^^ ™^ DIRECTORY NAME PORTION OF THE EXEC COM 
PATHNAME — 

&ec_dir 4— >udd>F01>Student 05 
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• CONTROL STATEMENTS 

D EXEC__COM LINES THAT BEGIN WITH SPECIAL KEY WORDS 

II ALL KEY WORDS BEGIN WITH & (AMPERSAND) 

D PROVIDE VARIETY AND CONTROL DURING EXECUTION 



&command__line off 

SUPPRESSES THE PRINTING OF SUBSEQUENT COMMAND LINES 

USAGE: icomrnand line off 



• ^command line on 

D CAUSES SUBSEQUENT COMMAND LINES TO BE PRINTED. (THE DEFAULT) 
USAGE: &coramand line on 
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CONtROL STATEMENTS 



&print text 



^ TRRMfLP" TEXT FOLLOWING &print TO BE PRINTED ON THE USER V 



TERMINAL 



D USAGE: &print text 

&print BEGINNING COMPILE PHASE 



&label location 




IDENTIFIES A PLACE TO WHICH AN &goto TRANSFERS CONTROL 



USAGE; &label label_name 
&label Arg_Check 
&label &1 




• &goto location 




CAUSE CONTROL TO BP TRjiM<5CirDDrn -rn -rur. or<,«„ ^^ 



USAGE: &goto label__name 
&goto Arg_Check 
&goto &1 
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STty -^Je.'i ecUf^^^ ^.0-^e . r-fi-^y 

CONTROL STATEMENTS 



.^^ 

^ 








--^-^^^■^^^Sv "^ ^'^^ 



• &if , &then, &else ^ ^"^^ 

ALLOWS EXEC__COM LINES TO BE CONDITIONALLr INTERPRETED"^ 



D USED WITH LOGICAL ACTIVE FUNCTIONS (WHICH RETURN "true" OR 
"false") 



USAGE 1: &if [ACTIVE^FUNCTION {ar^gs}] 
&then EXEC COM STATEMENT 



&if [exists seg add.pll] 
&then pll add.pll ; add 



USAGE 2: &if [ACTIVE^FUNCTION {args}] 
&then EXEC__COM STATEMENT 
&else EXEC^COM STATEMENT 

&if [equal [wd] [home__dir]] 

&then &goto OK 

&else &print Assuming working dir is correct 



USED TO INDICATE A COMMENT LINE 



D USAGE: & text 



& THIS EXEC COM DETERMINES THE USER'S Project id 
& AND THE TIME OF DAY IN ORDER TO 
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CONTROL STATEMENTS 



&quit 



D CAUSES EXECUTION OF THE EXEC COM TO HALT 
SEGMENT) 



(DEFAULT AT END OF 



Q USAGE: &quit 




CAUSES SUBSEQUENT COMMANDS WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO TAKE THEIR INPUT FROM THE EXEC COM SEGMENT 



II USAGE: &attach 



^ ^r^ j^-^-^ 







EXAMPLES: 



qedx REQUESTS ARE 
READ FROM TERMINAL 



&command line off 

cwd >udd>FED>May 

qedx 

cwd >udd>FED>Kerr 

• 




• 
• 



qedx REQUESTS ARE 
READ FROM EXEC COM 
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CONTROL STATEMENTS 




USED TO REVERT &attach 



CAUSES SUBSEQUENT COMMAND WHICH NORMALLY TAKE THEIR INPUT FROM 
THE TERMINAL TO CONTINUE TO TAKE THEIR INPUT FROM THE TERMINAL 




D THE DEFAULT WHEN ENTERINtTlN EXECjCOR-) 



USAGE: Jedetach 



• &input line off 



D SUPPRESSES THE PRINTING OF SUBSEQUENT INPUT LINES (SUCH AS 
REQUEST LINES) 



fl USAGE: &input_line off 



• &input line on 




D CAUSE SUBSEQUENT INPUT LINES TO BE PRINTEDVCDEFAULT) 
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CONTROL STATEMENTS 





CAUSES THE INVOCATION OF THE USER'S READY PROCEDURF AFTFR tup 
EXECUTION OF EACH COMMAND LINE WITHIN THE EXEC COM 




CAUSES THE USER'S READY PROCEDURE NOT TO BE INVOKl 
WITHIN THE EXEC COM ' 



(DEFAULT) ) 



• exec com DEFAULTS: 





&command__line on 
&input_line on 
&ready off 
&detach 
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EXEC COM EXAMPLES 



EXAMPLE 1: 



LET pl1__pr.ec CONTAIN: 

pl1_pr.ec 



ind 


&1 


.pl1 




pi1 


&i 


.pll 


-map 


dp 


8t1. 


list 




ind 


&2 


.pll 




pl1 


&2 


.pll 


-map 


dp 


&2. 


list 





LET THE COMMAND LINE BE: ec pl1 pr.ec add sub 



Q LET THE COMMAND LINE BE: ec pl1_pr.ec sub 



• EXAMPLE 2: LET pl1_pr.ec CONTAIN: 

pl1__pr.ec 




&comn^ind_line off 

&if Unless &n 1] &then &quit 

ind &1 .pll 

pll &1.pll -map 

dp &1 .list 

&if tt^n^quaD&n 13 &then &quit 

"ind &2.pl1 
pll &2.pl1 -map 
dp &2.1ist 
&quit 
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EXEC COM EXAMPLES 



EXAMPLE 3: 
CONTAIN: 



LET pl1__pr.ec HAVE AN ADD NAME OF pl1 pr .ec AND 



pl1_pr .ec 
pl1_pr_.ec 



. 



&goto &ec_name 

&label pl1__pr 

&command_line off 

&print Beginning &ec_name exec com 

&if [ngreater &n 0] &then &goto pl1 pr 

&print Usage is: ec &ec narae.ec paths" 

&quit "" 

&label pl1__pr 

dl &1 -brief 

ind &1 .pl1 

pll &1.pl1 -map 

& CHECK FOR A SUCCESSFUL COMPILE. (WAS OBJECT CREATED) 

&if [exists segment &1] &then dp &1.1ist 

^^^^ngreater &n 1] &then ec &ec__dir>pll_pr_.ec &2 &3 &4 
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EXEC COM EXAMPLES 



ADDITIONAL EXAMPLES OF EXE C__COM CONTROL STATEMENTS: 

&if [equal [day__name] Monday] &then 

&if [query "Do you really ...?"] &then 

&if [equal all [response "How many do you want?"] ] &then 
&if [equal TSmith.FED [last_message_sender] ] Athen ..... 

&if [equal S [substr [user name] 11]] &then 

&if [equal [min &1 &2 &3 &4] ] &then 

&if [or [equal ] [less ] ] &then 

&if [nless [index "&1 &2 &3 &M" -all] ] &then 

&if [equal [mod &n 2] ] &then 
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AREAS FOR ADDITIONAL STUDY 



ADDITIONAL DOCUMENTATION OF exec com FACILITIES 



S MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 



fl help exec com 



• STUDY TOPICS 



Q ARGUMENT SUBSTITUTION 



fl &qi, &ri (QUOTING AND REQUOTING OF ARGUMENTS) 

D &fi (THE ARGUMENT STRING STARTING WITH THE iTH ARGUMENT) 

fl &qfi, &rfi (QUOTING AND REQUOTING OF ARGUMENT STRINGS) 



CONTROL STATEMENTS 



&print CONTROL STRINGS: "/, "3/, '^-, -^4-, '^ j ^ -3 1 , '^^ 



YOU ARE NOW READY FOR WORKSHOP 
#7 
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^^{/\^^ ofi, ^^ 



£. 



yv/ 



jk 




£ l( le^-'rX £C f^j-^ 
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TOPIC XVII 
ABSENTEE USAGE 



PbsLq 
What is Absentee Usage 

Absentee Commands . . • • • • 17-1 

Areas for Additional Study' ' ' ' • • 17-7 

*•••••♦•••..... 17-9 
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WHAT IS ABSENTEE USAGE 



• ABSENTEE FACILITY 



I A FACILITY FOR RUNNING BACKGROUND JOBS (i.e. BATCH JOBS) 

" iStEhIcTI^E USa'ge""' "'''' '' "^"*^" '-°«^« THAN CHARGES Kon 



' XHE"15«SMsTSrLH*?x^^-?HEXBE*JrL^^^^^^^ 

' COmS^USMS^ua^e''""" "'*=' ^^ iSMIICAL TO THE INTERACTIVE 



• PROCESS 



A PROGRAM CREATED FOR THE USER AT LOG IN. AND DESTROYED AT LOG 



i AN ACTIVE AGENT WHICH DOES WORK FOR THE USER 

' SJrol'Sf'thI US^r""' «°«'^^"° IN ITS OWN MEMORY UNDER THE 
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WHAT IS ABSENTEE USAGE 



• INTERACTIVE USAGE 



D USING MULTICS INTERACTIVELY VIA A TERMINAL 



B USER»S PROCESS INTERACTS WITH THE USER 



• ABSENTEE USAGE 



I USING MULTICS WHILE ABSENT FROM A TERMINAL 



D USER'S PROCESS "INTERACTS" WITH AN INTERACTIVE SCRIPT 



fl AN ABSENTEE JOB IS A "PLANNED" INTERACTIVE TERMINAL SESSION 
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WHAT IS ABSEMTEE USAGE 



ABSENTEE MECHANISM 



" sf EXECUTED^ *" ^^^^"^^^ ^"^^^ SEGMENT CONTAINING COMMANDS TO 

B THE ABSENTEE INPUT SEGMENT 
I MUST HAVE SUFFIX OF absin 

CONTAINS A PLANNED INTERACTIVE SCRIPT INCLUDTnir phfcift 
ANSWERS TO ANTICIPATED QUESTIONS INCLUDING PRESET 

1 HAS THE SAME SYNTAX AS EXEC COM SEGMENTS 



TH^PntSI^^fP "^ EXECUTION OF THE ABSENTEE INPUT SEGMENT VIA 
THE enter_abs_request COMMAND •jnuncm via 



1 EXECUTION MAY BE DEFERRED UNTIL A SPECIFIED DATE AND TIME 

° N2^«AT?l!?L^C?i%\"^^SRL%Ar^ ''' «"« *^ '''^''^^'^ ^° ^HE 



" tFrM?H?''"S.v?«J?*^i:L'^^''ECTED TO THE TERMINAL IS REDIRECTED TO A 
El^fpf THE"*ru?Plx'?I It'tL.''^' '' ™^ '^'^'^'^ INpSt'^EgSeNT 
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WHAT IS ABSENTEE USAGE 



INTERACTIVE USAGE 




COMMANDS 



RESPONSES 



ri^- 




USER'S 
TERMINAL 



FILE I/O 



ABSENTEE USAGE 




A.absin 



COMMANDS 



RESPONSES 



FILE I/O 



MtMMtA * 



A.abtout 



(M% 1 «l 


: 1 


> 1 ■ n »» •«»«• • • 

• M a/^ ■• • • . 

• wiMA • • • 
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WHAT IS ABSENTEE USAGE 



THE ABSENTEE PROCESS WHICH RUNS THE JOB: 

LOGS INTO THE SYSTEM AS DOES ANY fiqjri? .'e-vz-cb^ r^«« « 

AUTHENTICATION) ^"^^ ^cXCEPT FOR PASSWORD 

EXECUTES THE ABSENT USER'S start__up.ec 

BEGINS WORKING IN THE ABSENT USER'S HOME DIRECTORY 
D TAKES ITS COMMANDS FROM THE ABSENTEE INPUT SEGMENT 

1 APPEARS (AND IS) ANOTHER USER HAVING THE ABSENT USER'S User id 



COMMAND LINE FLOW 

ABSENTEE INPUT 

1 

{ABBREV PROCESSOR} 

i 

COMMAND PROCESSOR 
I 

EXECUTION 



''-' FO, 



WHAT IS ABSENTEE USAGE 



NOTES ON ABSENTEE USAGE 



^ AbIenTEE*LOG^?n"^^ ^^ MODIFIED TO RESPOND DIFFERENTLY TO AN 

I THE SYSTEM EXECUTES A USER'S start UD ec WITH onf hf thf 
FOLLOWING COMMAND LINES: ^^^rz__up.eQ WITH ONE OF THE 

ec stsrt_up.ec login interactive 

ec start_up.ec login absentee 

ec start_up.ec new^proc interactive 

ec start_up.ec new_proc absentee 

D THE USER MAY QUERY THE ARGUMENTS USING exec com r TMpq 
SIMILAR TO THE FOLLOWING: exec_com LINES 

4if [equal 41 login] &then ... 
&if [equal &2 absentee] &then ... 

D THE ABSENTEE INPUT SEGMENT MUST CONTAIN chance wdir rOMMAwn rr 
WORKING DIRECTORY IS TO BE OTHER THAN HOME dJrIcTORY ^^ 

u xnL AoSENTEE input SEGMENT OFTEN (BUT NEED NOT^ uac i a. ao 

fXNAL command ©«i/Mi# tiij 

D IF THE ABSENTEE JOB CANNOT BE RUN. OR IF TT tprmtmatitc 
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ABSENTEE COMMANDS 



enter_abs_request, ear (BATCH NEVER LOOKED LIKE THIS!) 

" Q^^^ES A REQUEST FOR THE CREATION OF AN ABSENTEE PROCESS 

USAGE: enter_abs__request path {-control_args} 
ear weird. absin 
ear weird. absin -restart 
ear trans. absin -time "Friday 9pm" 
ear trans. absin -queue 1 -arguments add sum 



• list_abs_request , lar 

PRINTS INFORMATION ABOUT ABSENTEE REQUESTS 

D USAGE: list_abs_request {-control^args} 
lar 

lar -q 1 
lar -all 
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ABSENTEE COMMANDS 



• cancel_abs_request, car 

D CANCELS AN ABSENTEE REQUEST WHICH IS STILL QUEUED 

USAGE: cancel__abs_request request_id {-control^args} 
car weird. absin 
car trans. absin -q 1 
car -id 202008 



• answer 



PROVIDES PRESET ANSWER(S) TO QUESTION(S) ASKED BY A COMMAND 

D PRIMARILY FOR USE IN ABSENTEE INPUT SEGMENTS 

D THE ANSWER IS PROVIDED AN UNLIMITED NUMBER OF TTiirci hmt ccc 
LIMITED BY THE -times CONTROLT^CURir ""^^ ^^^^^^ 

1 UNUSED ANSWERS ARE IGNORED 

D USAGE: answer ans {-control^args} command^line 
answer yes delete^dir Dir A 
answer yes -times 2 help send_message 
answer rest help trace 
answer no answer yes -times 2 help trace 
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AREAS FOR ADDITIONAL STUDY 



ADDITIONAL DOCUMENTATION 

MPM COMMANDS AND ACTIVE FUNCTIONS (AG92) 

help enter__abs_request 



STUDY TOPICS 

D CONTROL ARGUMENTS 

II -output^file, -limit, -brief 

ABORTING OF AN ACTIVE ABSENTEE PROCESS (THERE IS NO "GRACEFUL" 

DELETE ACCESS TO THE absin SEGMENT 
D DELETE ACCESS TO THE absout SEGMENT 
D CALL OPERATOR 

Q SELF PERPETUATING ABSENTEE PROCESSES 
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TOPIC XVIII 
SOFTWARE CONVENTIONS 



Page 

Command Language Special Symbols 18-1 

Segment Name Suffixes 18-7 

Suffix Convention !!.'!!! 18-9 

Canonical Form .......!!!!! 18-10 

set_tty Command , [ , ] , 18-12 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



(PERIOD) 



IDENTIFIER ^^"^^^^^^^ ^^ ^^ ENTRYNAME, STAR NAME, OR ACCESS 



A__test . alpha . cobol 

».».pir 

Student 04.F01 .m 



• _ (UNDERSCORE) 

fl SIMULATES A SPACE FOR READABILITY IN ENTRYNAMES 
ran__num__gen . basic 

fl IS NOT AN ABBREV BREAK CHARACTER 

I ALL SYSTEM SUBROUTINES END IN 



• > (GREATER-THAN) 



I DENOTES HIERARCHY LEVEL (TOP DOWN) 



SEPARATES THE ENTRYNAMES IN A PATHNAME 

>udd>F01>Student_01>tools>my^editor.pll 



^^"'^ F01 



COMMAND LANGUAGE SPECIAL SYMBOLS 



• < (LESS-THAN) 



D INDICATES ONE LEVEL BACK UP IN THE HIERARCHY 



D EXAMPLES ASSUMING WORKING DIRECTORY IS >udd>FED>LJones>tools 

cwd < 

cwd >udd>FED>LJones 

cwd << 

cwd >udd>FED 

pr <start up.ec 

pr >udd>FlD>LJones>start_up.ec 

pr <<TSmith>tools>random 

pr >udd>FED>TSmith>tools>random 



* (STAR OR ASTERISK) 



(s?Af LtENTION)"""''' °' *" ENTRYNAMEOR ACCESS IDENTIFIER 



list seg_1.*.» 

list seg_1 .»» 

sa ».* r LJones.*.a 



18-2 pQi 



COMMAND LANGUAGE SPECIAL SYMBOLS 



? (QUESTION MARK) 



CONVENTION) ^^^^^^ ^^ ^ COMPONENT OF AN ENTRYNAME (STAR 



list s???.old.pll 
list s??.»» 



= (EQUAL) 



5e^uL''cSt\'^^^^^ CORRESPONDING COMPONENT OF AN ENTRYNAME 



* (STAR) AND = (EQUAL) ARE SYMMETRICAL IN MEANING 



rename random. gen .pll ordered. r.= 
rename random. gen. pll ordered .gen .pll 

rename random. data. base =.= 

rename random. data. base random. data 

rename beta my__=.old 
rename beta my__beta.old 

rename *.new.pl1 =.old.r 
rename beta. new. pll beta. old. pll 

add_name **.ec s=,absin 
add^name pl1_pr.ec pll pr?absin 
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COMMAHD LANGUAGE SPECIAL SYMBOLS 



% (PERCENT) 



IS REPLACED BY THE CORRESPONDING CHARACTER OF A COMPONENT NAME 
(EQUAL CONVENTION) 



? (QUESTION MARK) AND % (PERCENT) ARE SYMMETRICAL IN MEANING 



rename my_old__ed.pl1 %%%nevi%%% . :z 

rename my__old_ecl.pl1 my_new_ed.pl1 

rename ????*. data %$%.= 

rename alpha_2.data alp. data 



• ; (SEMI-COLON) 

fl USED TO SEPARATE MULTIPLE COMMANDS IN A COMMAND LINE 
cwd dir__a; list; cwd dir_b;ls 



• - (MINUS SIGN) 

D IDENTIFIES CONTROL ARGUMENTS 

list -directory 

dprint -he TSmith -ds MS106 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



( ) (PARENTHESES) 



D CAUSES COMMAND ITERATION 



print (A B add) .pll 

print A. pll 
print B.pll 
print add. pll 



sm Student__0(1 3 5).F01 Return to the classroom 

sm Student^OI.FGI Return to the classroom, 
sm Student_03.F01 Return to the classroom, 
sm Student_05.F01 Return to the classroom 



rename (A B add). pll (a b Add). pll 

rename A.pH a. pll 
rename B.pll b.pH 
rename add. pll Add. pll 



create__dir (newXfirst second) old>third) 

create_dir new>first 
create_dir new>second 
create dir old>third 
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COMMAND LANGUAGE SPECIAL SYMBOLS 



[ ] (BRACKETS) 

D DELIMITS ACTIVE STRINGS. (EVALUATED BY ACTIVE FUNCTIONS) 
sra tlast_message_sender j Thanks! 



• $ (DOLLAR SIGN) 



SEPARATES THE ENTRYNAME OF AN OBJECT SEGMENT FROM THE ENTRY 
POINT NAME WITHIN THE OBJECT SEGMENT ^'^'^"^^^ *" «"" THE ENTRY 



DEFAULT ENTRY POINT NAME IS THE ENTRYNAME 



add 
add$add 



add$niax 
add$max 



" (QUOTES) 



^VMRnff ^^ ^"^ ^^^^^^^ ^^^^^^^ OF COMMAND LANGUAGE SPECIAL 



SYMBOLS 



rename ";»' foo (segment name is: ;) 

delete "A B" (segment name is: A B) 

delete "A""B" (segment name is: A'»B) 

delete A""B (segment name is: AB) 
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SEGMENT NAME SUFFIXES 



absin ABSENTEE INPUT SEGMENT FOR THE enter_abs_request COMMAND 

'''"' tmZ'm °'''"' ''"'''" '''"''" ''' ^"^ enter_abs_request 

acs ACCESS CONTROL SEGMENT USEFUL TO THE 10 DAEMON 

aim ALM SOURCE SEGMENT 

apl APL WORKSPACE SEGMENT 

archive SEGMENT MANIPULATED BY THE archive COMMAND 

basic BASIC SOURCE SEGMENT 

bind BINDFILE FOR THE bind COMMAND 

breaks BREAK SEGMENT USED BY THE debug COMMAND 

"'' Sand''' "'''' '''''' segment for the create_mrds_db 

"'"" CoSmaS"* 2"^-"°^^'' SOURCE SEGMENT FOR THE create_n,rds_dsn, 

cobol COBOL SOURCE SEGMENT 

code ENCIPHERED SEGMENT CREATED BY THE encode COMMAND 

compin INPUT SEGMENT TO THE compose COMMAND 

compout OUTPUT SEGMENT CREATED BY THE compose COMMAND 

SnD "'^'^^^^^^ ^^^MENT CREATED BY. THE add_dict_words 

CoSmaSS""' ^"^-MO^E^ segment created by the create_mrds„dsm 

COMMAND FILE FOR THE exec_com COMMAND 

fortran FORTRAN SOURCE SEGMENT 

gcos SEGMENT IN GCOS STANDARD SYSTEM FORMAT FOR THE gcos COMMAND 

info SEGMENT FORMATTED FOR USE BY THE help COMMAND 

iodt I/O DEVICE TABLE 



^^-'^ F01 



diet 

dsm 

ec 



SEGMENT NAME SUFFIXES 



linus 

list 

lister 

listform 

listin 

mbx 

memo 

motd 

mrpg 

ms 

Pll 

profile 
qedx 
symbols 

wl 



LINUS MACRO SEGMENT FOR THE LINUS invoke REQUEST 

LISTING SEGMENT CREATED BY A LANGUAGE PROCESSOR 

LISTER DATA FILE (STRUCTURED) FOR THE process_list COMMAND 

LISTER FORMS DESCRIPTOR SEGMENT FOR THE process_list COMMAND 

LISTER DATA FILE (ASCII) FOR THE create^list COMMAND 

MAILBOX SEGMENT FOR THE mail COMMAND 

DATA SEGMENT FOR THE memo COMMAND 

DATA SEGMENT FOR THE print_motd COMMAND 

SOURCE SEGMENT FOR THE MULTICS REPORT PROGRAM GENERATOR'S 
mrpg COMMAND 

MESSAGE SEGMENTS FOR RJE 

PL/1 SOURCE SEGMENT 

DICTIONARY SEGMENT FOR THE ABBREV PROCESSOR 

MACRO SEGMENT FOR THE qedx TEXT EDITOR 

SPEEDTYPE SYMBOL DICTIONARY CREATED BY THE add symbol 
COMMAND 

WORDPRO WORDLIST SEGMENT CREATED BY THE create wordlist 
COMMAND 
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SUFFIX CONVENTION 



• ALL COMMANDS WHICH ONLY WORK ON SEGMENTS HAVING A GIVEN SUFFIX 
WILL APPEND THAT SUFFIX TO ENTRYNAMES TYPED WITHOUT THE SUFFIX 



archive a Field_work summary_report 
archive a Field__work. archive summary report 



basic ran_num_gen -list 
basic ran num gen. basic -list 



cancel_abs_request weird 
cancel_abs_request weird, absin 



cobol A_alpha 
cobol A__alpha .cobol 



enter_abs_request weird -tm 6pm 
enter_abs_request weird. absin -tm 6pm 



exec_com A_create add sum 
exec com A create. ec add sura 



fortran array_dot 
fortran array dot. fortran 



indent add 
indent add.pll 



pll add -optimize 
pll add.pH -optimize 
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CANONICAL FORM 



MOTIVATION 

HOW WAS THE FOLLOWING LINE TYPED? 
The only one! 



The onlyBBBB^ one! 

- or - 
he oB_nB_lB__yB_ one! 

- or - 

The __Bo_Bn__Bl_By one! 









COMPARISON OF TWO INTERNAL LINES SHOULD BE BASED ON RESULTINC 
PRINTED IMAGE 



THEREFORE, ALL INPUT SHOULD BE CONVERTED TO A STANDARD 
(CANONICAL) FORM 



MULTICS AUTOMATICALLY TRANSLATES ALL TERMINAL INPUT TO 
CANONICAL FORM (UNLESS THE USER REQUESTS OTHERWISE) 



SHOULD THE USER NOTICE THAT SOME TEXT IS NOT STORED IN THE SAME 
SEQUENCE AS IT WAS TYPED, CANONICALIZATION SHOULD BE EXPECTED 
(FOR EXAMPLE, DURING CERTAIN TEXT EDITING OPERATIONS) 
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CANONICAL FORM 



OVERSTRIKES ARE STORED IN ASCENDING ASCII ORDER SEPARATED RY 
THE BACKSPACE CHARACTER ^^.x. unucit, btPAKfliED uY 



EXAMPLES: (B = BACKSPACE, C = CARRIAGE RETURN, N = NEWLINE) 



TYPIST: >B<B b<B> 

TYPED LINE: g ~ j 
CANONICAL FORM: <B>B <B>B 



TYPIST: The onlyBBBB 

TYPED LINE: The orOir 



CANONICAL FORM: The ~B^Bn_Bl_By 

?YPrn\'TMt. ^® ^^^ "^ P'^Q^ ^len^C N 

TYPED LINE: We see no problem ~ 

CANONICAL FORM: WB Be see no problem 
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SEt TTV COMMAND 



TERMINAL TYPES 



I MULTICS ATTEMPTS TO RECOGNIZE TERMINAL TYPE AT DIAL-UP TIME 



I EACH TERMINAL TYPE HAS A SET OF DEFAULT I/O MODES 



TERMINAL I/O MODES AFFECT CHARACTER CONVERSION, DELAY TIMES. 
AND COMMUNICATION LINE CONTROL 







MODIFIES TERMINAL TYPE AND/OR MODES ASSOCIATED WITH TERMINAL 
I/O 



I USAGE; set_tty -control_args 

stty -terminal^type TN300 

stty -ttp ARDS 

stty -ttp ti745 ^^ 

stty «ttp rosfl^^ 

stty -nodes lfecho,fulldpx /i^ 

sttr-prlnt..^^^^^^^ o^.^^^^^^^^^^^^/^^^ 

stty -rtset 

stty f^Bf~T,W^Q]o\o ,^'^ /^^^rw- '^ff^^' 'f^ A'''----^ 

stty -edit AB/ 
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SET TTY COMMAND 



f( 



TERMINAL I/O MODES 



can J can 



/^. 



i' n 




/f /W 



£^ 




D PERFORMS STANDARD CANONICALIZATION /(DEFAULT IS 



ON 



capo , capo 



OUTPUTS ALL LOWERCASE LETTERS IN UPPERCASE ^<5efIuLT iToTf 




Ifecho 



uSrS^a rAPPrfrf^oc^nL^^^^ FEED Ti^-^H^U^j^^IHpyT STREAM 
WHEN A CARRIAGE RETURN IS TYPED ((DEFAULT IS OFF}) 



crecho, ^crecho 



^ ^^^HOP A CARRIAGE RETURN WHEN A LINE FEED IS TYPED^fDEFAULT 



e fulldpx, "fulldpx 



^^^LOWS^^^^M^^ TO RECEIVE AND TRANSMIT SIMULTANEOUSLY 



D echoplex, "echoplex 



ECHOES ALL CHARACTERS TYPED ON THE TERMINAL <DEFAULt" is" OF^ 
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F01 



SET TTY COMMAND 



I edited, ''edited 



SUE£IISSES.™-EJmi' 
(tPE FAULT IS o ff) 



sue£iisses_™-efii|iting of unprintable characters - like \014 
:default is 



j^. 



O...AM-^Cl 



af tabV *t8b 



727r^( <. '-^^ 



I inserts JTA BS IN OUTPUT IN PLACE OF SPACES WHEN APPROPRIATE 
DEFAULT IS OFF>^ 



tabecho, "^tabecho 



I ECHOES THE Ap&QBEXATi; JUJBBER OF SPACES WHEN A HORIZONTAL 
TAB IS TYPED (^DEFAULT IS OFF)) 



politey ''polite 



J DOES NOT SEND OUTPUT^TOJtHE-IEiMINAL UNTIL THE CARRIAGE IS 
AT THE LEFT MARGIN /CBEFAULT IS OFF) 



§ replay, '"replay 



REPRINTS ANY PARTIAL TMPUT LINE THAT IS INTERRUPTED BY 
OUTPUT. (^DEFAULT IS OFFFj 



YOU ARE NOW READY FOR WORKSHOP 
#8 
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TOPIC XIX 
ADDITIONAL COMMANDS 



Page 

Access to the System 

Storage System, Segment Contents* [ ', [ in" 3 

Storage System, Manipulation .... io ?n 

Formatted Output Facilities ... lo ^ 

Performance Monitoring . . It'lr 

Debugging ....::;;: ^-^ 

Command Level Environment ]q]1 

Accounting i9-id 

Absentee Computations !.'.'.' 19-18 

Miscellaneous Tools . . 19-19 

19-21 
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ACCESS TO THE SYSTEM 



dial, d 



D CONNECTS AN ADDITIONAL TERMINAL TO AN EXISTING PROCESS 



" ^Spr^^rSn o^^^^^^/!i^5^"^^ ^°^ ^ ^^^^^^ ^^ PROCESS HAVING THE 
SPECIFIED Person__id AND Project__id THAT IS ACCEPTING DIAL-UPS 



" INFORMATION^^-"^"^^^""- ^"^^^"^^^^ DESCRIPTION (AK92) FOR MORE 



D USAGE: dial dial_id Person_id . Project_id 
d 411 TransProcHSD 



enter, e 
enterp, ep 



D CONNECTS AN ANONYMOUS USER TO THE SYSTEM 



^ DOES^"^^'^ REQUEST DOES NOT ASK FOR A PASSWORD WHEREAS enterp 

Q USAGE: enter {anonymous_name} Project id 
enterp {anonymous_name} Project id 
e JDoe FED 
ep JDoe FED 
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ACCESS TO THE SYSTEM 




USED TO GAIN ACCESS TO THE SYSTEM 

1 USAGE: login Person_id {Project__id} {control__args} 

login TSmith 

login TSmith F01 -cpw -ns -modes If echo 

login TSmith F01 -gpw -cdp -ring 5 

login TSmith -force -hd >udd>FED>Kerr 




TERMINATES A USER SESSION 

1 USAGE: logout {-control_args} 

logout -bf 
logout -hold 
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ACCESS TO THE SYSTEM 



{• MAP 7 






TELLS MULTICS THAT THE TERMINAL IS AN UPPERCASE-ONLY TERMINAL 

MUST BE INVOKED BEFORE THE ACCESS rfqfif<5t r ^ rr 
(PREACCESS ONLY) ALULbb REQUEST (e.g., login) 

i^A^f mC^LASHf ^^ LOWERCASE EXCEPT FOR CHARACTERS PRECEDED 



USAGE: MAP 



#(^29 AND 963j> 

D TELLS MULTICS THAT THE TERMINAL IS AN EBCDIC OR IBM 27^11 

MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g., login) 
D USAGE: 029 -OR- 963 



^^'^ FOl 



ACCESS^ TO THE SYSTEM 





CAUSES THE GREETING MESSAGE TO BE REPEATED 



MUST BE INVOKED BEFORE THE ACCESS REQUEST (e.g. login) 



SEFUL IF THE GREETING WAS GARBLED (AS WOULD OCCUR WITH AN 
EBCDIC TERMINAL OR BECAUSE OF LINE NOISE) 



^ USAGE: hello 
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STORAGE SYSTEM^ SEGMENT CONTENTS 



edm 




INVOKES A SIMPLE, INEXPENSIVE TEXT EDITOR (A SUBSYSTEM 

USAGE: edm {path} 
edm 
edm add.pll 




° CAPABILITIES"^ '^^^ ^^"^^ ^^ SUBSYSTEM) HAVING MACRO 



II USAGE 1: 

(MANUAL EDITING) 



qedx 
qx 



USAGE 2: 

(MACRO EDITING) 



qedx path {optional_args} 

qx conv_ft.qedx Random. fortran 
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STORAGE SYSTEM > SEGMENT CONTENTS 




archive, ac HLIKE SARDINES) 




COMBINES AN ARBITRARY NUMBER OF SEPARATE SEGMENTS INTO ONE 
SEGMENT (THE ARCHIVE SEGMENT) 



Q A MEANS OF ORGANIZING SEGMENTS (IDENTITY OF EACH SEGMENT IS 
PRESERVED) 



SAVES PHYSICAL SPACE BY COMPACTING SEGMENTS TOGETHER 



fl THE ARCHIVE SEGMENT MUST HAVE A SUFFIX OF archive 



CONSTITUENT SEGMENTS ARE CALLED COMPONENTS OF THE ARCHIVE 
SEGMENT 



I THE COMMAND IS ALSO USED TO EXTRACT COMPONENTS FROM THE ARCHIVE 
AND RETURN THEM TO INDIVIDUAL STORAGE SYSTEM SEGMENTS 



^^il 



i z Z t/ 



S USAGE: archive key path components ^ 



ac r bound_pl1_prgins.s add. pi 1 sub. pi 1 
ac rd bound_pl1_prgms.s [segs **.pl13 
ac X bound_pl1_prgms.s. archive sub.pll 
ac t bound__pll_prgms.s 
ac d bound_pl1_prgms.s add.pH 
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STORAGE SYSTEM, SEGMENT CONTENTS 




KEY 



I TABLE OF CONTENTS OPEJlAXim L ( t , tl, tb, tlb) 

APPEND OPERATION (a. ad, adf, ca, cad, cadf) 

Q REPLACE OPERATI ON (r, rd, rdf, cr, crd, crdf) 

fl UPDATE OPERATION (u, ud , udf, du, cud, cudf) 



D ELETE OPERATION (d, cd) 



JXTMMl OPERATION (x, xf) 



;;X22/^^^ 




^rt^tr^^ ,^ 






.^^ 



X.archiye 




ac a X A C B 
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STORAGE SYSTEM, SEGMENT CONTENTS 




bind, bd y< . . . AND THEY SHALL BECOME AS ONE) 



D PRODUCES A SINGLE BOUND (PRE-LINKED) OBJECT SEGMENT FROM ONE OR 
MORE UNBOUND OBJECT SEGMENTS 



D THE OBJECT SEGMENTS TO BE BOUND MUST FIRST BE PLACED IN AN 
ARCHIVE SEGMENT 



g THE CONTENTS OF THE ARCHIVE SEGMENT ARE THEN "BOUND" TOGETHER 



USAGE: bind paths {-control_args} 
bd editor^mods. archive 




bind 




bound_ABC.archive 



bound ABC 



bd bound_ABC 
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STORAGE SYSTEM, SEGMENT CONTENTS 



• compare_ascii, cpa 



COMPARES TWO ASCII SEGMENTS AND PRINTS THE CHANGES MADF TO Thp 
CONTENTS OF PATH1 TO YIELD THE CONTENTS OF PATH2 



^ l^l AMOUNT OF LOOK AHEAD FOR RE-SYNCHRONIZING IS DETERMINED BY 
THE min_chars AND min lines ARGUMENTS 



Q DEFAULT min^chars IS 50, DEFAULT min lines IS 5 

D USAGE: eompare_^ascii path1 path2 {min_chars} {inin_lines} 
cpa genum.old.pll genum.new.pl1 



adjust_bit_count/, abc 





CORRECTS THE BIT COUNT OF A SEGMENT (AN ATTRIBUTE STORED IN THE 
^^^M^i?^*'^ DIRECTORY) TO REFLECT THE ACTUAL BIT CoSnT 0^ ThI 



" PB^rBL°^^^^^^ ^^^"^ ^^ *" INCONSISTENT STATE (BY AN ABORTING 
rKOuRAM, ETC) 



USAGE: adjust_bit_count path {-control^args} 
abc temp 
abc output_file -Ig 
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STORAGE SYSTEM, MANIPULATION 



• link, Ik (DON'T CONFUSE WITH DYNAMIC LINKING) 



D CREATES A LINK TO A SPECIFIED SEGMENT OR DIRECTORY 



D THE LINK "LOOKS" LIKE THE REAL THING TO MOST COMMANDS 



B USED TO SAVE PHYSICAL SPACE AND/OR REDIRECT STORAGE SYSTEM 
ACCESSES 



D FREQUENTLY USED BY A PERSON BELONGING TO SEVERAL PROJECTS TO 
LINK HIMSELF TO A COMMON MAILBOX, start-up. ec, profile, etc. 



D USAGE: link path1^ {path2} 

Ik >udd>FED>Kerr>dev>x_sort >udd>FED>Kerr>tools>sort 

Ik >udd>FED>Kerr>dev>x__sort sort 

Ik >udd>FED>Kerr>dev>x_sort 

Ik [hoine_dir]>(Cseg3[hoine dir]>«»]) 



unlink, ul 

DELETES THE SPECIFIED LINK ENTRY 

USAGE: unlink paths 
ul sort 
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LINKING EXAMPLE 1 



F01 

T 



Student.04 



I 



Student.07 




] 



seg.2 
I 



add.7 C^^^ CJl) C^^ 




03 
•-4 
O 
» 

o 
w 

03 

00 

•-4 

m 

3E 



as. 
i-i 

c: 

> 

o 



o 



link >udd>F01>Student.07>add add>7 
link >udd>F01>Student.07>seg,2 



LINKING EXAMPLE 2 



I ^^° I 



Lyon 






ro 




XY2 



Tom 



start up.ec 

I 
I 
I 
I 
I 



[To TSmith's _ 
home directory 



Lyon .mbx 



Pat 



J 








Lyon.nibx J Atart up.ec^ 






I 
I 



o 

> 
o 

m; 

CO 

m 



> 

H 
no 

c 

>^ 

M 

o 

SB 



link >udd>MMPP>Lyon>(start.up.ec Lyon.rnbx) 
link >udd>MMPP>Lyon Pat 
link >udd>WOPS>TSmith Tor 



FORMATTED OUTPUT FACILITIES 



• dump_segment,/ds 

fl PRINTS A SEGMENT'S CONTENTS IN OCTAL, ASCII, OR BCD 

USAGE: dump^segment path {first} {n__words} {-control_args} 
ds prince 400 20 
ds add -bed 

• sort_seg, as 

/ 

' ^!^BE^S'''' y''''' ACCORDING TO THE ASCII 



^ ll^?fn,,J\^f?2^|L^2!i2 ^^^^ SEPARATE SORT UNITS DELIMITED BY 
SPECIFIED DELIMITER STRING. SORT UNITS ARE THEN SORTED 



8 USAGE: sort_seg path {-control_args} 
ss tel_data.old 

^® tel_data.old -delimiter xx -descending 
ss tel_data.old -sm tel_data.new -unique 
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PERFORMANCE MONITORING 



• cumulative_page_trace, cpt 



ACCUMULATES PAGE TRACE DATA SO THAT THE TOTAL SET OF PAGES USED 
FOR A COMMAND OR PROGRAM CAN BE DETERMINED 



USAGE: cuniulative_page_trace command^line {-control__args} 
cpt add -reset 
opt -print 






PRINTS INFORMATION ABOUT THE EXECUTION OF INDIVIDUAL STATEMENT! 
WITHIN A PL/I, FORTRAN, OR COBOL PROGRAM 



II PROGRAMS MUST HAVE BEEN COMPILED WITH THE -profile CONTROL 
ARGUMENT 



USAGE: profile path {-control_args} 
profile add 
profile add -reset 
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DEBUGGING 



fl PBINTS THE USER'S STACK HISTORY - MOST RECENT FIRST 

S USAGE: trace_stack {-control_args} 
ts 
ts -depth 5 



• trace 



MONITORS CALLS TO SPECIFIED PROCEDURES 

B PROCEDURES MUST HAVE ORIGINATED FROM PL/I OR FORTRAN SOURCE 

i USAGE: trace {-control__args} names 
trace add 
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COMMAND LEVEL ENVIRONMENT 



/ ■ / 



• llne_length(, 11 



SETS THE MAXIMUM LENGTH OF OUTPUT LINES 

WRAP-AROUND, IF IT OCCURS, IS PRECEDED BY "\c»» 

USAGE: line_length maxlength 
11 118 



• rtady oCf , rdf 

^ V. ^, - 

TURNS OFF THE READY MESSAGE 



USAGE: ready_off 
rdf 



• ready on, rdn 



fl PRINTS A READY MESSAGE AFTER EACH COMMAND LINE HAS BEEN 
PROCESSED (THE DEFAULT) 



E USAGE: ready_on 
rdn 
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CONMAND LEVEL ENVIRONMENT 




• ge 



meral ref^dy, 



gr 




LLOMS USER TO FORMAT THE READY MESSAGE 



USAGE: general_ready {-control^arg} 
gr -string "DONE MASTER" -set 
gr -string » -call print__messages -set 
gr -string READY -hour : -minute -inc^cost 
gr -control * -set 
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ACCOUNTING 



• get_quota, gq 



D RETURNS INFORMATION ABOUT STORAGE QUOTA AND USAGE FOR A 
SPECIFIED DIRECTORY 



1 DOES NOT «get« THE USER ANY MORE QUOTA 



I USAGE: get_quota {paths} {-control^args} 
gq dir_A 
gq -long 



I 



m resoyree_usa9%, ru 



PRINTS A REPORT OF RESOURCE CONSUMPTION FOR THE CURRENT BILLING 
PERIOD 



i USAGE; resource^usage {-control__args} 
ru 
ru -long 
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ABSENTEE COHIPUTATIONS 



D 

f ortran_abs K^^^ 



SUBMITS AN ABSENTEE REQUEST TO PEitFORM FORTRAN COMPILATIONS AND 
dprint COMPILER'S OUTPUT 



USAGE: fortran_abs paths {-ft_args} {-dp_args} {-abs_args} 
fa array_dot .fortran 
fa array dot -map -copy 2 



pll^abs^'^pa J 



SUBMITS AN ABSENTEE REQUEST TO PERFORM PL/I COMPILATIONS AND 
dprint COMPILER'S OUTPUT 



USAGE: pll_abs paths {-pl1_args} {-dp_args} {-abs_args} 
pa add.pll 
pa add -optimize -queue 1 -hold 
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ABSENTEE COMFUTATIONS 



runoff_abs/i rfa / 



SUBMITS AN ABSENTEE REQUEST TO PROCESS TEXT SEGMENTS (USING THE 
RUNOFF COMMAND) AND dprint THE OUTPUT 



I USAGE: runoff_abs path {-rf_args} {-ear_arga} {-dp^args} {-abs 
rfa prince. runoff 
rfa prine© -in 10 -tm 8pm -ep 3 



• cobol abs 



SUBMITS AN ABSENTEE REtUEST TO PERFORM COBOL COMPILATIONS AND 
dprint COMPILER'S OUTPUT 



i USAGE; eobol_8bs paths Ccokol^args} {dp^arga} (-abs^args) 
ca add. cobol 
ea add -optimize -queue 1 -hold 
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MISCELLANEOUS TOOLS 





ROVIDE THE USER WITH A CALCULATOR (A SUBSYSTEM) 



ACCEPTS FORTRAN-LIKE EXPRESSIONS 



fl pi AND e ARE BUILT-IN VARIABLES 



USAGE: calc 

calc 

x=pi » 3.4 »» 2 

3.57 * 2«»(x ♦ 10.7)/sin (35.7) 

q 



• encode 



^ 



ENCIPHERS A SEGMENT'S CONTENT ACCORDING TO A KEY SUPPLIED BY 



THE USER 



encode ASKS TWO TIMES FOR THE ENCIPHER KEYWORD 

D ENCIPHERED SEGMENT IS GIVEN A SUFFIX OF code 

USAGE: encode path 1 {path2} 
encode blacklist 
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MISCELLAHEOUS TOOLS 



• decode 



RECONSTRUCTS AN ORIGINAL SEGMENT FROM AN ENCIPHERED SEGMENT IF 
PROPER KEY IS SUPPLIED 



decode ASKS FOR THE ENCIPHER KEYWORD 



1 USAGE: decode pathi {path2) 
decode blacklist 



• new^proc 

DESTROYS THE USER'S CURRENT PROCESS AND CREATES A NEW ONE 
D EFFECTIVELY THE SAME AS LOGGING OUT AND LOGGING IN AGAIN 

ASSUMES THE SAME CONTROL ARGUMENTS THE USER GAVE AT LOG IN 

1 USAGE: new_proc {-eontrol_arg) 

new proc 



YOU ARE NOW READY FOR WORKSHOP 
#9 
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TOPIC XX 
SOFTWARE OVERVIEW 



Page 

The Operating System . , 20-1 

System Security I '. , . , 20-2 

Ring Mechanism !!!!!!!!!! 20-8 

System Daemons .!!!!' 20-9 

System Libraries and Directories ..!!!!! 20-11 

Application Packages ...!'*** 20-16 
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THE OPERATING SYSTEM 



MORE THAN 95% OF THE OBJECT CODE ORIGINATED FROM PL/[ SOUKCE 
(1 ,132,000 LINES) 



LESS THAN 5% OF THE OBJECT CODE ORIGINATED FROM ALM ASSEMBLY CODE 
(226,000 LINES) 



m TOTAL OBJECT CODE OCCUPIES MORE THAN SIX MILLION WORDS OF ST 



• HIGHLY STRUCTURED (3300 MODULES) 



• CODE IS PURE, RECURSIVE AND RE-ENTRANT 



• ON-LINE INSTALLATION OF SYSTEM MODULES 



• EXTENSIVE ON-LINE METERING AND TUNING FACILITIES 
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SYSTEM SECURITY 



• "...Multies Is properly characterized as the most secure 
commercial operating system available.** 

Prof. Peter J. Denning 

Computer Science Dept. 

Purdue University 

(Computing Europe, July 29, 1976) 



• Multics security architecture is superior to any other 
commercially available system (by 2 to 1 ratio). 

Mitre Corporation Study for 
U.S. Air Force - Sept., 1975 
(USDC Order No: AD-A009221) 



• SYSTEM ACCESS: USER AUTHENTICATION 



USER AUTHENTICATION REQUIRED TO LOG IN 



D PASSWORD IS DETERMINED AND CHANGED BY USER, AT WILL (RANDOM 
PASSWORD GENERATION IS AVAILABLE IF DESIRED) 



ONLY A NON-REVERSIBLE RESIDUE OF EACH PASSWORD IS STORED 



I NOTIFICATION OF INCORRECT PASSWORD USAGE 



E LAST LOG IN NOTIFICATION 
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SYSTEM SECURITY 



VIRTUAL MEMORY 



i INVISIBLE ABSOLUTE MEMORY ADDRESSES 



fl ADDRESS SPACE UNIQUE TO PROCESS 



D RESIDUE CLEARED PRIOR TO PAGE ALLOCATION 



• FILE AND PROGRAM ACCESS: ACL (DISCRETIONARY) 



Tu^ of^?o^nf^n^^^^^^^^^ ^^^ PROTECTS USERS FROM OTHER USERS ON 
THE BASIS OF Person_id AND Project id 



EVERY SEGMENT AND DIRECTORY HAS AN ASSOCIATED ACCESS CONTROL 
LIST 



THEy''mIy''aCCESS W "^'^ ^^^^^^ * SEGMENT OR DIRECTORY AND HOW 



DIRECTORY -S^OWNEf"^" " ^"^ DISCRETION OF THE SEGMENT ^S OR 
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SYSTEM SECURITY 



• FILE AND PROGRAH ACCESS: AIM (NONDISCRETIONARY) 



AIM (ACCESS ISOLATION MECHANISM) MECHANISM SEPARATES AND 
PROTECTS USERS FROM OTHER USERS ON THE BASIS OF SECURITY LEVEL 
AND THE NEED TO KNOW 



Q EVERY SEGMENT, DIRECTORY AND USER HAS AN ASSIGNED SENSITIVITY 
(SECURITY) LEVEL AND CATEGORY SET 



Q AIM RESTRICTS SEGMENT AND DIRECTORY ACCESS TO USERS BELONGING 
TO THE SAME CATEGORY SET AND HAVING THE SAME, OR HIGHER, 
SENSITIVITY LEVEL 



B SENSITIVITY LEVELS AND CATEGORY SETS ARE ASSIGNED BY THE SYSTEM 
ADMINISTRATOR (UP TO 8 LEVELS AND 18 CATEGORIES) 



I USERS CANNOT "GIVE AWAY" ACCESS OR WRITE DATA INTO A LOWER 
SENSITIVITY LEVEL REGARDLESS OF ACL PERMISSIONS 



n AIM IS A SITE CONTROLLED OPTION 



TOP SECRET 

SECRET 

UNCLASSIFIED 



CATEGORY 
NATO CIA AIR FORCE NAVY 
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SYSTEM SECURITY 



FILE AND PROGRAM ACCESS: RINGS (INTRAPROCESS) 



D THE RING MECHANISM SEPARATES AND PROTECTS THE OPERATING SYSTEM 
FROM THE USERS 



THE RING STRUCTURE IS AN 8 LEVEL (0 THRU 7) 
MASTER-MODE/SLAVE-MODE HIERARCHY 

- CENTRAL SUPERVISOR (MOST PRIVILEGED) 
D 1 - SYSTEM ROUTINES 

D 4 « NORMAL USER RING 

1 7 - HIGHEST USER RING (LEAST PRIVILEGED) 
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SYSTEM SECURITY 
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SYSTEM SECURITY 



EACH SEGMENT HAS AN ATTRIBUTE WHICH IS A SET OF INTEGERS KNOWN 
AS RING BRACKETS 



THE RING BRACKETS DEFINE FROM WHICH RING(S) A PROCESS MAY READ, 

writFTTall, or execute that segment 



D EACH PROCESS IS CREATED IN A GIVEN RING DETERMINED AT LOGIN 



A PROCESS MAY TEMPORARILY CHANGE ITS RING OF EXECUTION BY 
EXECUTING A PROGRAM CALLED A GATE — - — 

EXAMPLE: 

B A DATA BASE IN A LOWER RING THAN A USER CAN ONLY BE 
ACCESSED BY THAT USER VIA AN OWNER WRITTEN "GATE" 
PROCEDURE - REGARDLESS OF AIM AND ACL PERMISSIONS 

fl HARDWARE ENFORCED AT EVERY ACCESS 



20-7 F01 



RING MECHANISM 



RING MECHANISM SUMMARY 



WRITE 



READ 



WRITE 
BRACKET 



READ BRACKET 






EXECUTE 
BRACKET 



EXECUTE 



CALL BRACKET 



GATE 
BRACKET 



J 



RING OF EXECUTION 



U 



u- 



CORRESPONDING 
PERMITTED ACTIONi 

READ, WRITE, 
EXECUTE <WITH RIN 
CHANGE) 



EXECUTE 



READ, EXECUTE 



EXECUTE (IF A GATI 
ONLY, AND WITH Rll 
CHANGE) 



NOME 



• SUBJECT, OF COURSE, TO ACL AND AIM 
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SYSTEM DAEMONS 



Daemon 



A SYSTEM SERVICE PROCESS THAT PERFORMS A SPECIFIC TASK SUCH AS 
PROCESS CREATION, BACKUP, NETWORK CONTROL, PERIPHERAL I/O 



D LOGGED IN BY THE OPERATOR AND CANNOT "TIME OUT" AS A USER MIGHT 



Backup. SysDaemon 



A PROCESS DESIGNED TO PRODUCE BOTH INCREMENTAL AND CONSOLIDATED 
BACKUP COPIES OF THE STORAGE SYSTEM 



fl BACKUP IS TO MAGNETIC TAPE 



fl SITE DETERMINES THE FREQUENCY OF THE BACKUPS 



• Card Input. Daemon 



A PROCESS DESIGNED TO MANAGE THE SYSTEM CARD READER(S) 



10. SysDaemon 



A PROCESS DESIGNED TO MANAGE THE SYSTEM'S LINE PRINTERS AND 
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SYSTEM DAEMONS 



• Dumper .SysDaemon 



8 A PROCESS DESIGNED TO PRODUCE A COMPLETE BACKUP OF THE STORAGE 
SYSTEM 



GCOS, SysDaemon 



A PROCESS DESIGNED TO AID IN THE SIMULATION OF A GCOS 
ENVIRONMENT ON MULTICS 



I ALLOWS STANDARD GCOS JOBS TO BE SUBMITTED FROM EITHER PUNCHED 
CARDS OR IMCV TAPES 



• Initializer .SysDaemon 



THE SYSTEM'S PRIMARY PROCESS. PERFORMS THE FOLLOWING 
FUNCTIONS: 



Q ANSWERING SERVICE OPERATIONS (login, dial, logout/etc) 

B OPERATOR COMMAND SERVICE 

OPERATOR TERMINAL MANAGEMENT AND MESSAGE ROUTING 

1 SYSTEM ACCOUNTING AND ADMINISTRATION 

§ USER REQUEST HANDLING (logout, new_proe, etc) 
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SYSTEM LIBRARIES AND DIRECTORIES 



ROOT 



system . 
library,^ 
auth^msint 







svstem„library_ 
sll 



D 



sy$tein_library_tools 
tools 



system control 1 
scl 



DOoo 6666 66 6 




• COMIVIANDANO 
SUBROUTINES OF 
THE LOCAL 
AUTHORMENTIOiy 
LISRABV 

• ted. lisp, pascal 



• HARDCORE OPERATING 
SYSTEM PROCEDURES 

• RELOADED EACH TIME 
THE SYSTEM IS 
REINITIALIZED 



• COMMANDS AND SUBROUTINES 
SUBROUTINES USED TO 
ADMINISTER, MEASURE 

AND MAINTAIN THE 
SYSTEM 

• PRIMARILY OF INTEREST 
TO SYSTEM PROGRAMMERS 



I whotab j ( motd ] 




PLUS MISCELLANEOUS ACCOUNTING 
LOG, LINE USAGE. PASSWORD SEGMENTS 
AND THE I/O RESOURCE CONTROL 
PACKAGES 
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ROOT 



o 
I 




tyrt«n_lil»rary_«t»n<ta<^ 



m ALL COMMANDS AND 
SUBROUTINES PROVIDED 
ASPARTOFMULTICS 



ONE 

DIRECTORY 
PER PROCESS 



• PLUI OTHER TCMPOHARV SEGMENTS CREATED 
At NEEDED 



ostr_dir_«Kr 



(PROJECT NAME) 



uMbondtod 

o o o 

» LINUS, MRDS. MRPG 



} 



ONE 

DIRECTORY 
PER PROJECT 



(USER NAME) 



1} 



ONE 

DIRECTORY 
PER USER 



65. 

m PERSONAL SEGMENTS 
AND DIRECTORIES 
OF THIS USER 






to 
so 

so 

1-4 

m 

l>, 

o 

S9 

o 
•-1 
o 
so 
»-« 
m 

€/) 



o 



o 



LO 




experimental 
exi 



system__library_network 



CONTAINS OBSOLETE 
OBJECT SEGMENTS 



• CONTAINS SYSTEM 
DUMPS FOR 
CRASHES, ETC. 



• CONTAINS SYSTEM 
SOFTWARE USEFUL 
FOR HANDLING THE 
GCOS ENCAPSULATION 



• CONTAINS SYSTEM • 
SOFTWARE WHICH 

IS BEING DEVELOPED 

• CONTAINS PROCEDURES 
BEING USED IN PLACE 
OF SYSTEM PROCEDURES 
WHICH ARE FAULTY 



CONTAINS OBJECT SEGMENTS 
FOR NETWORK PROCESSING 
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SYSTEM LIBRARIES AND DIRECTORIES 



firmwars 



• CONTAINS THE FIRMWARE 
REQUIRED iV VARIOUS 
PERIPHERAL DEVICES 
(i.t,. TAPE AND DISK 
CONTROLLERS) 



ROOT 



daamon. 
dir_dir 
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• DIRECTORIES AND 
SEGMENTS OF THE 
BACKUP AND I/O 
DAEMON PROCESS 




00 



dooMiMntatkm 
doe 



inei_tnfo. 



tibr«rv..dir_< 
idd 



• SEE NEXT P 



^C^ Ul 



INFO SEGMENTS 


• INSTALLATION 


• OTHER USEFUL 


FOR THE Mp 


MAINTAINED 


DOCUMENTATION 


COMMAND 


info SEGMENTS 


OIRECTORtESANI 
SEGMENTS 
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Iibr«fv_dir_ilir 
kid 



ro 
o 



VJ1 



ONE FOR EACH OF THE 

FOLLOWING: 

iVit«m_ Hbrmry _nertwork 
system _libr ary _ob*oJ9t8 

* unbundlad 

tools ( 

* hardcore ^s\^ arxl scl) / 

* communication | 

* bos *> 

* language 



source 
s 



include 
inci 



object 
o 



lists 
I 



ooo ooo ooo 



u 



listings 



6 



□ [ 



T 



• ALL PL/1 INCLUDE 
FILES 



bound_full_cp_.s.archive 

bound_full_cp_.archive 



bound_full_cp _.list 
(bind listmgs) 



660660660 

• CONTAINS PL/1 LISTINGS 
FOR SYSTEM PROGRAMS 

• LOCATED ON A SEPARATE 
LOGICAL VOLUME WHICH 
MAY BE REMOVED 

• CONTAINS 9 DIRECTORIES: 

bos 

languages 

standard 

tools 

obsolete 

comm 

unbufKlled 

rtetwork 

hardcore 



00 
CO 

m 

3: 



m 

> 
w 

M 
W 
W 

l> 



so 

o 

o 
to 

tn 



THESE CONTAIN ADDITIONAL DIRECTORIES 



O 



APPLICATION PACKAGES 



• HULTICS DATA BASE HANAGER (HDBH) 

B MULTICS INTEGRATED DATA STORE (MIDS) 

SUPPORTS NEr*'ORK DATA BASES 

1 A SUBSET or IDS-II 

1 PROCEDURAL INTERFACE (USER SPECIFIES HOW TO SEARCH) 

D MULTICS RELATIONAL DATA STORE (MRDS) 

SUPPORTS RELATIONAL DATA BASES 

1 INDUSTRY'S FIRST COHNERCIALLY AVAILABLE RELATIONAL DBN 

D NON-PROCEDURAL INTERFACE USING ENGLISH-LIKE EXPRESSIONS 
(USER SPECIFIES GOAL OF SEARCH) 

Q SET OPERATIONS ON RELATIONS (I.E. ON FILES): 
a UNION, INTERSECTION, DIFFERENCE 

BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 
B AND, OR, NOT 

i ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
EQUAL, GREATER THAN, LESS THAN, NOT 

i BUILT-IN FUNCTIONS 

abs, after, before, etll, eoneat, floor, indiei, nod, 
r%yer9%, round, search, substr, verify 
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APPLICATION PACFCAGES 



• LOGICAL INQUIRY AND UPDATE SYSTEM (LINUS) 



END USER FACILITY FOR ACCESSING RELATIONAL DATA BASES 



fl ENGLISH-LIKE EXPRESSIONS 



i FIND THE AVERAGE SALARY OF EMPLOYEES IN THE SHOE DEPARTMENT 

avg {select salary 

from employee table 
where dept = "Ihoe'*} 



BOOLEAN OPERATIONS BETWEEN CONDITIONS FOR SELECTION: 
D AND, OR, NOT 

ALGEBRAIC COMPARISONS ON ATTRIBUTES (I.E. ON DATA FIELDS): 
3 EQUAL, GREATER THAN, LESS THAN, NOT 

FIND THE NAMES OF EMPLOYEES WHO ARE EITHER IN THE ADMIN 
DEPARTMENT OR WHOSE TOTAL INCOME EXCEEDS $10,000 

select name 

from employee_table 

where dept = "Admin" I salary+comm> 10000 
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APPLICATION PACKAGES 



1 SET OPERATIONS ON RELATIONS (I.E. ON FILES): 



UNION, INTERSECTION, DIFFERENCE 



FIND THOSE ITEMS WHICH ARE SUPPLIED BY LEVI AND SOLD IN THE 
MEN»S DEPARTMENT 

select Item 
from supply 
where supplier s "Levi" 
inter 

select item 

from sales 

where dept s "Men" 



S BUILT-IN FUNCTIONS 



Q abs, after, before, ceil, concat, floor, index, nod, reverse, r< 
search, substr, verify 



!l max, min , sum, ave, count 



D PERMITS USER DEFINABLE FUNCTIONS (I.E., MACROS) 
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APPLICATION PACKAGES 



MULTICS REPORT PROGRAM GENERATOR 



S A FACILITY FOR GENERATING FORMATTED REPORTS 



MRPG 

SOURCE 

(USER WRITTEN) 



INPUT 
TO 



DATA 

(USER 
SUPPLIED) 



INPUT 
TO 



MRPG 



GENERATES 



♦ 



REPORT 
PROGRAM 



CREATES 



FORMATTED 
REPORT 
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APPLICATION PACKAGES 



• VORD PROCESSING (WORDPRO) 



fl A COLLECTION OF FACILITIES FOR ENHANCING THE ON-LINE PREPARATION 
DISTRIBUTION, AND MAINTENANCE OF DOCUMENTS 



II CONSISTS OF SUCH TOOLS AS: 



fl SPEEDTYPE COMMANDS 







Efiff 







iKptncI lywliuli 
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APPLICATION PACKAGES 



i compose FACILITY 



.Ma StTitltK 

.fla !i:%l>ao0No%.i 



> .1 _ i^^k 



M 10 

II i^'ii*liM I <"> ^'ii iirii, 



A»60inpHi 



compoie 




A.C(H11pOUt 



WORDLIST COMMANDS 



D ELECTRONIC MAIL COMMANDS 



TEXT EDITOR 
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APPLXCATIOH PACKAGES 



I LIST PROCESSING CONNANOS 




for<i|ty> 









pfocm.liit 



Yourofdw 
for 20 



^i^ ^ ^i ^ ^<^ 
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APPLICATION PACKAGES 



ONLINE DICTIONARIES 





wordlitt 




> unb > standard.dict 

/I 



trim wordlist 




frsd 
(20,000 WORD 
DOCUMENT) 



frsd.Mrf 
(5,000 UNIQUE 
WORDS) 



frad.wl 
(100 POTENTIALLY 
MISSPELLED WORDS) 



TEXT COMPARISON PROGRAMS 



Today we 
caught 20 
large fish. 
Tomorrow we 
climb Mt, 
Everest 



Dear Mom: 
Today we 
caught 20 
small fish. 
Tomorrow we 
dimb Mt 
funk. 



compare_ascii 



B 



Inserted in B: 

B1 Dear Mom: 

Preceding: 

A1 Today we 

A3 large fish 

Changed by B to: 
B4 small fish 

A6 Everest 

Change by B to: 
B7 Punk. 
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APPLICATION PACKAGES 



• Multlcs GRAPHICS SYSTEM 



I DEVICE INDEPENDENCE 



1 USER SEES ONLY "VIRTUAL GRAPHICS TERMINAL" (VGT) 



Q EACH DEVICE HAS A "GRAPHIC DEVICE TABLE" (GDT) 






I SIMPLE ITEMS (LINES, POINTS) COMBINED TO CREATE MORE COMPLEX 



I GRAPHIC OBJECTS MAY BE "SHARED" (EX. CREATE A WHEEL ONCE. 
INCLUDE M TIMES IN AN AUTOMOBILE STRUCTURE) 



ALL ITEMS ARE THREE DIMENSIONAL 

1 OBJECTS MAY BE NAMED 

I OBJECTS MAY BE PERMANENTLY STORED 

I ANCILLARY INFORMATION STORED WITH OBJECT 

I SCALING 

I ROTATION 

20«24 pQ^ 



APPLICATION PACKAGES 



D EXTENT 

D INTENSITY 

COLOR 

D DOTTEDNESS 

BLINKING 

SENSITIVITY TO LIGHT PENS, ETC. 

D EDITING FACILITIES 

D MAY EDIT THE WORKING GRAPHIC SEGMENT (WGS) 

REAL TIME EDITING AT TERMINAL 

CONTROLLED BY Multics (ANIMATION, DYNAMIC GRAPHICS) 

i PERMANENT STORAGE OF GRAPHIC OBJECTS 

fl TERMINALS SUPPORTED 



fl TEKTRONIX H002 
4012 
4013 
4014 
4015 
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APPLICATION PACKAGES 



I ARDS 



e CALCOMP 915/1036 (PLOTTER) 
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TOPIC XXI 
HARDWARE OVERVIEW 



Page 

Hardware Description P- . 

System Requirements p- I 

Configuration Limits & Records ... 21 5 
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HARDWARE DESCRIPTION 



LEVEL 68 CENTRAL PROCESSOR UNIT 

1 A MODIFIED LEVEL 66 CPU 

36-BIT WORD MACHINE (9 BITS/BYTE, n BYTES/WORD) 

D VIRTUAL MEMORY HARDWARE 

D DIVIDES MEMORY INTO SEGMENTS 

I SEGMENTS CONSIST OF TO 256 PAGES 

PAGE =1024 WORDS (1K WORDS) 

D RING PROTECTION HARDWARE 

fl ACCESS ENFORCING HARDWARE 

D HIGH-SPEED CACHE MEMORY 
i 2048 WORDS 
D HIT RATIO GREATER THAN 85% 
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HARDWARE DESCRIPTION 



I EXTENDED INSTRUCTION SET (EIS) 

BLOCK MOVE INSTRUCTION (ENTIRE SEGMENT) 

D BOOLEAN OPERATION INSTRUCTIONS 

D PICTURE EDITING INSTRUCTIONS 

11 4,6, OR 9-BIT ARITHMETIC INSTRUCTIONS 

fl POINTER MANIPULATION INSTRUCTIONS 

D GCOS MODE (ONE SWITCH) 
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SYSTEM REQUIREMENTS 



• A SMALL MULTICS CONFIGURATION 

NUMBER 

68/60 CENTRAL PROCESSOR (CPU) i 

D WORDS OF MEMORY (K = 1024) 256K 

D SYSTEM CONTROL UNIT (SCU) 1 

I/O MULTIPLEXER (lOM) 1 

D FRONT-END NETWORK PROCESSOR (FNP) 1 

D MSU0400 2 MASS STORAGE UNITS (MSU) 2 

fl MTUOilOO MAGNETIC TAPE UNITS (MTU) 2 
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SYSTEM REQUIREMENTS 



A LARGE MULTICS CONFIGURATION (1 TO 10 GROWTH CAPABILITY) 



NUMBER RATIO 



68/80 CENTRAL PROCESSORS 6 (1:6) 



D WORDS OF MEMORY (M=,1 ,048 ,576) 16M (1:64) 



SYSTEM CONTROL UNITS 8 (1:8) 



I/O MULTIPLEXER (# lOM'S + # CPU'S < 8) 2 (1:2) 



D FRONT-END NETWORK PROCESSORS 4 (1:4) 



D MSU0451 MASS STORE UNITS 512 (1:256) 



u MTU0500 MAGNETIC TAPE UNITS 16 (1:8) 
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CONFIGURATION LIMITS & RECORDS 



MEASURE 

NUMBER 
OF USERS 



RECORD SITE 



457 



HIS, PHOENIX 
(JUNE »77) 



KNOWN LIMIT 

1632 

(408 USERS » 4 DATANETS) 



NUMBER 
OF CPU's 



6 AFDSC, PENTAGON 7 

(AUG »77) (PORT LIMITATION) 



MAXIMUM 
REAL MEMORY 



4M 



HIS, Phoenix 
(SEPT '78) 



16M 

(8 SOU'S » 512K) 



MINIMUM 
REAL MEMORY 



192K HIS, CAMBRIDGE 1 92K 

(1971 - 1977) (BOOT LIMITATION) 



VIRTUAL MEMORY 
PER PROCESS 



256M 

(1024 SDW's « 256K) 



TOTAL VIRTUAL 
MEMORY 



19. 4B 

(512 MSU'S * 38, COOK) 



NUMBER OF 28 
DISK DRIVES 



AFDSC, PENTAGON 512 

(JAN »76) (CABLE LENGTH LIMIT) 



K = 2»»10 
M = 2**20 
B = 2**30 



1 ,024 

1,048,576 

1,063,741,824 
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APPENDIX A 
MULTICS DOCUMENTATION 



Page 

Multics Programmers* Manual (MPM) . . a i 

Multics Pocket Guides ' ' ^"'' 

Multics Administrators' Manuals (MAM) ! a f 

Program Logic Manuals (PLM) ... ' ^ n 

Other Multics Manuals ... ^"^ 

help Manuals .... ^"^ 
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M^LTICS PROGRAMMERS' MANUAL (MPM) 



Reference Guide 



Order No. AG91 



Sultics oo^^nfLH^""'^^ contains general information about the 
nuitics command and programming environments. It also dpfin^^ 
Items used throughout the rest of the MPM's and, in addUion 

svs?em ^Ld"?t °'^"?5' f' .''" ^^'""^^"^ language the sorag^ 
system, and the input/output system. 



Commands and Active Functions 



Order No. AG92 




Subroutines 



Order No. AG93 




Subsystem Writers' Guide 



Order No. AK92 



The MPM Subsystem Writers' Guide is a reference of interest to 



majority of users. 



Peripheral Input/Output 
The MPM I/O 



manual contains 



Order No. AX49 
descriptions of 
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MULTiCS POCKET GUIDES 



Commands and Active Functions Order No. AW17 

This pocket guide presents an abbreviated version of the 
commands and active functions described in detail in the Multics 
Programmers* Manual Commands and Active Functions 
Order No. AG92 
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MULTICS ADMINISTRATORS* MANUALS (MAM) 



Project Administrator Order No. AK51 

nroi^^?^^^!^^'^ i^ J ^"""^^ ^° ^^^ operation of programs in the 
pruject- aaministration area. The information in this manual is 
of interest not only to project administrators but also to 
accounting administrators (who may function as projec? 
administrators) and to system administrators (who may function 
m any administrative capacity). lunction 

Registration and Accounting 

Administrator Order No. AS68 

The Accounting MAM is a guide to the operation of MuUios 
billing and accounting programs. It is necessary that both the 
accounting and system administrators know how to perform the 
Multics billing operations. 

System Administrator Order No. AK50 

The System MAM is a guide to the overall administration of the 

«di^i?^f.!S^-^^"^. ?'^ ™^""^^ discusses the contents of 
administrative directories and data bases and special user 
Identifies (such as the daemons), describes installation 
parameters and system logs, explains the various tasks that are 
the responsibility of the system administrator, and includes ?he 
commands needed to carry out these responsibilities. Also the 
trSAnystem'' '''''" ^^^"^^'^ administrator are explain^d'in' 
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PROGRAM LOGIC MANUALS (PLM) 



NOTE: The Distribution of Program Logic Manuals is Restricted 



ALM Assembler Order No. AN69 



Carry Facility Order No. AN76 



Hardware & Software Formats Order No. AN87 



Reconfiguration Order No. AN71 



Storage System Order No. AN61 



System Dump Analysis Order No. AN53 



System Initialization Order No. AN70 



System Metering Order No. AN52 



System Tools Order No. AN51 



User Ring I/O System Order No. AN57 
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OTHER MULTICS MANUALS 



APL Users' Guide 



Order No. AK95 



BASIC 



Order No. AM82 



COBOL Reference Manual 



Order No. kS^H 



COBOL Users' Guide 



Order No. AS^IS 



DFAST Subsystem Users' Guid( 



Order No. AT59 



FAST Subsystem Users' Guid( 



Order No. AU25 



FORTRAN Reference Manual 



Order No. AT58 



GCOS Environment Simulatoi 



Order No. AN05 



Graphics System 



Order No. AS40 



Hardware Diagnostic Aid, 



Order No. AR97 



Logical Inquiry and Update System (LINUS) 



Order No. AZ49 



Multics Integrated Data Store 
Reference Manual 



Draft 
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OTHER MULTICS MANUALS 



Multics Relational Data 3tore 

Reference Manual Order No. AW53 



New Users' Guide Order No. AL40 



Online T&D Reference Manual Order No. AU77 



Operator's Handbook Order No. AM81 



PL/I Language Specification Order No. AG94 



PL/I Reference Manual Order No. AM83 



Processor Manual Order No. AL39 



SORT/MERGE Order No. AW32 



Site Preparation Manual Order No. DC79 



System Summary Description Order No. AK15 



Virtual Memory Order No. AG95 



WORDPRO Reference Guide ORder No. AZ98 
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HELP MANUALS 



THE MULTICS TECHNICAL MANUALS ARE LISTED BELOW ALL 
MANUALS/UPDATES THAT SPECIFY A DATE IN THE DATE COLUMN CAN BE 
ORDERED FROM THE DISTRIBUTION CENTER; FOR INFORMATION ABOUT HOW 
TO ORDER MANUALS TYPE: j-«r umiHiiuw aduui huw 

help order manuals 



mL,u,^ Ti'^^?^,' no°.^"n?.o''°^^ '*°^ CONTAIN A DATE FOR A MANUAL, THAT 
MANUAL IS "IN PROGRESS;" WHEN A DATE IS SPECIFIED, YOU CAN ORDER 

JL 1 • 



PROGRAM LOGIC MANUALS (PLMS) ARE LISTED SEPARATELY, AFTER THE LIST 

SLnnrT^R^T^^PQ^^rl^^H^* _ MARKETING DOCUMENTS (E.G., BROCHURES, 
PRODUCT BRIEFS, ETC.) ARE NOT INCLUDED. 



THIS MANUAL LISTING WAS CURRENT AS OF JULY 23, 1979 



Order Through 

Number Rev. Add. Release Date Title 



CUSTOMER 


MANUALS 


+AG90 


-01 




AG91 


-02 


A 


AG92 


-02 


A 
B 
G 
D 


AG93 


-02 


A 
B 


AG94 


-02 


A 
B 

C 



+AG95 -00 



05/73 MPM - Introduction 
7.0 03/79 MPM - Reference Guide 
8.0 

5.0 01/77 MPM - Commands and Active Functions 
6.0 11/77 
7.0 02/79 

f . va -. — — — — 

8.0 

6.0 02/78 MPM - Subroutines 

7.0 12/78 

8.0 

5.0 07/76 PL/I Language Specification 
6.0 10/77 
7.0 12/78 
8.0 

06/72 Virtual Memory 
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HELP MANUALS 



AK50 



-01 







B 






C 






D 


AK51 


-01 


A 
B 
C 


AK92 


-02 


A 


AK95 


-01 


... 




-02 


... 


AL39 


-00 


A 




-01 


.— . 


AL40 


-01 


... 




-02 


... 


AM81 


»01 


A 
B 




-02 


... 


AM 82 


-00 


.., 


AM83 


-00 


A 




-01 


.. 


AN05 


-01 


.. 


AN50 


-01 


.. 




-02 


.. 


AN52 


-01 


.. 


AN76 


-01 


A 


AR97 


-01 


A 


AS^IO 


-00 


.. 




-01 


.. 


ASil3 


-01 


A 
B 
C 


AS1I4 


-01 


A 
B 
C 
D 


AS68 


-00 


A 
B 


AT58 


-01 


A 
B 



5.0 10/76 MAM - System 

5.0 03/77 

6.0 03/78 

7.0 10/78 

8.0 

4.0 08/76 MAM - Project 

6.0 04/78 

7. n 09/70 

8.0 

7.0 03/79 MPM - Subsystem Writers* Guide 

8.0 

7.0 03/79 APL Users' Guide 

8.0 — — 

04/76 Processor Manual 

09/76 

6.0 07/77 Introductory Users' Guide 

8.0 Programmer's Introduction to Multics 

6.0 10/77 Operators' Handbook 

C (\ rk 1 /rr O 

U . U U I / f O 

7.0 02/79 

8.0 

1.0 02/74 BASIC 

4.0 06/76 PL/I Reference Manual 

7.0 09/78 

8.0 -^..- 

7.0 10/78 GCOS Environment Simulator 

7.0 03/79 Index to Multics Manuals 

8.0 — .. 

7.0 02/79 System Metering 

7.0 11/78 Carry Facility 

7.0 12/78 

6.0 07/78 Hardware Diagnostic Aids 

6.0 11/78 

6.0 10/77 Graphics System 

8.0 

5.0 12/76 COBOL Users' Guide 

6.0 04/78 

7.0 02/79 

7.0b 

5.0 12/76 COBOL Reference Manual 

6.0 10/77 

7.0 01/79 

7.0 05/79 

7.0b 

4.0 11/76 MAM - Registration and Accounting 

7.0 01/79 

8.0 

5.0 02/77 FORTRAN 

6.0 11/77 

7.0 06/78 
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C 






D 


AT59 


-00 


— _ 


AU25 


-00 


A 


AU77 


-01 







-02 


— _, 


AW17 


-00 


._ 




-01 


— _. 


AW32 


-00 


— _, 


AW53 


-02 


... 


AX49 


-00 


A 
B 


AZ03 


-00 


... 




-01 


... 


AZ49 


-01 


... 


AZ98 


-01 


... 



7.0 01/79 

8.0 

3.1 03/76 DFAST Subsystem Users' Guide 
3.1 03/76 FAST Subsystem Users' Guide 
8.0 

6.0 10/77 Online Test and Diagnostics Reference Manual 

7.0 

3.1 04/76 MPG - Commands and Active Functions 
8.0 

4.0 07/76 SORT/MERGE 

7.0 10/78 Relational Data Store (MRDS) Ref. Manual 

5.0 06/77 MPM - Peripheral Input/Output 

7.0 01/79 

8.0 

5.0 08/77 System Programming Tools 

8.0 

7.0 10/78 Logical Inquiry and Update System (LINUS) 

7.0 11/78 WORDPRO Reference Manual 

A 8.0 

CC34 -01 — 7.0 03/79 Bulk Input/Output 

■ A 8.0 

6.0 03/78 Report Program Generator (MRPG) 

7.0 01/79 FORTRAN Users' Guide 

8.0 

7. OR 11/78 MAM - Resource Control Package (RCP) 

8.0 

7.0 11/78 MAM - Communications 

8.0 

7.0 10/78 MPM - Communications I/O 

8.0 — — 

7.0TP 06/79 Transaction Processing 

7.0 Remote Batch Facility (Lev 68/Lev 6)(Prelim) 

7.0a qedx User's Guide (Preliminary) 

8.0 compose User's Guide 

8.0 Debugging User's Guide 

8.0 New User's Introduction to Multics - Part I 

8.0 New User's Introduction to Multics - Part II 

8.0 Error Messages 

8.0 emacs User's Guide 



CC69 


-00 


CC70 


-00 




-01 


oC74 


-00 


CC75 


-00 


CC92 


-00 


* 




ICC96 


-01 


CG18 


-00 


CG40 


-00 


CG41 


-00 


CH23 


-00 


CH24 


-00 


CH25 


-00 


CH26 


-00 


CH27 


-00 
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HELP MANUALS 



PROGRAM LOGIC MANUALS 

AN51 -00 — — 02/75 System Tools 

AN53 -00 06/75 System Dump Analysis 

AN57 -00 05/77 User Ring Input/Output System 

AN61 -00 — 5.0 07/74 Storage System 

A 6.0 09/78 

AN63 -00 — -— 02/75 ALM Assembler 

AN69 -00 --- 02/75 Message Segment Facility 

AN70 -00 02/75 System Initialization 

AN71 -01 04/77 Reconfiguration 

AN80 -00 Library Maintenance 

AN85 -01 7.0a Communications System 

AN87 -00 07/76 Hardware & Software Formats 

NOTES: 



* A line has been deleted since the last time this segment was updat 

I This line has been modified since the last time the segment was up 

+ Some of the information in this manual is obsolete 

MPM Multics Programmers* Manual 

MAM Multics Administrators' Manuals 

MPG Multics Pocket Guide 
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MULTICS TECHNICAL BRIEFS 




Interactive Programming Environment 
Controlled Sharing and Security 
Multics PL/I .... 

Multics APL ." ! ; * 

Multics Data Base Manager . 

LINUS . . : : 

Word Processing System WORDPRO 
Multics Graphics System .... 
Multics Electronic Mail Facility 
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Honeywell 



SERIES 60 (LEVEL 68/DPS) 



level 68/ Distributed 
Processing System 



t^m DP^^ If vel 68/Distributed Processing Sys- 
tern (DPS), with the Multics operating svstem 
offers tne user many powerful features 'including 

problems quickly and easily. '"°''^'™8 
The Level 68/Distributed Processing System con 

ules can be added m mcremental steps, thus offer- 
ing a choice of various levels of perfon^ance ThL 
easy expansion allows a user to configureThe 
^e^xact^^tem needed and helps prot;r,;im^^ 

VIRTUAL MEMORY 

l^vel 68/DPS virtual memory efficiently and auto- 

and'?co'„d"an"'°™^"°f "^^^^^ mairmemory 
ana secondary storage - independent of hardware 

^nfiguration and without programme?i„temn«on 

TT^us, programs are not constrained by main mem 

oiy limitations and no overlays are requked ?ur 

thermore user I/O can be handled loricaUv w^hn„f 

concern for physical addresses. IntegrS of tte 

68/DPS storage (file) system with vSual memoit 

addressing forms a powerful data handhng 3 

than 300 billion bytes of stores information 
SECURITY 

structured for maximum data security With simni<. 

(S,rdTnRf°"^;'^!!^"^--.'^Shts'' 
thesel cnn ik^; kI — ^7' "'"'=. or comDinations of 
same nie ^"'"*"' '° "^'^^^'^"^ "^^^ °f 'he 




Since hardware enforces the basic 68/DPS 

k'^TZ^^'^u"^'^'' "^'^ '""« system overhead 
s introduced by access control enforcement. After 

Icce^ htr^'^ '° "'''^ '"^ °" ^^^-^ memory 
aS tb^ ,r ' '°™''?''' *^ ''"^'"P'^d access 
against the user s permission. Thus, no additional 
machine instructions are executed for security 

MODULARITY 

TTie modular design of the Level 68/Distributed 
Processing System has significant advantages for 
processing flexibility and for system growth Tie 
optimum combination of processor, memory and 
'^^J^'^^f^^ -'^"'es can beS.I 
-o. .aw. ...swuation. integrated Network Proc- 

Sdl^fn"" f T f"bsystems, and peripherals 
. rt additional modules that can be added lo tailor 

m to^r"" ;," "• ^ ^''' '■«/'^''S ^y-^'-' sup, r" 
up to 6 million bytes of memory (Ibur n,illion 
words) and employs two or more processors for 
maximum availability. Memory can bo a.ld 'd 

incremLn , '' 'T'' ""^"""'^ "'^-^ ^' -^'^'^^ "' 
increments of two million bytes. 
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This approach allows a site to purchase equipment 
for today^s processing needs and add modules to 
meet a growing data processing workload. Further- 
more, each configuration can be given the proper 
nax of processing, storage, and I/O capacity, and 
modified as necessary to meet changing workload 
characteristics. Re^dless of the configuration 
selected, the full functionality of Multics is avail- 
able. Any program that can run on the largest sys- 
tem can also run on the smallest, and vice versa. 

Another significant advantage of Level 68/DPS 
modular architecture is the capability for con- 
figuring fully fail-safe systems. This is accom- 
plished by including additional system control 
units. I/O multiplexers, network processors, and 
appropriate peripheral subsystems. Note that it is 
not nece^ary to add processor modules since 
Level 68/DPS always contains at least two. 

PROCESSOR MODULE 

The Level 68/DPS processor module executes pro- 
grams and handles aU computations. For example, 
it performs instruction fetching, relative and abso- 
lute address preparation, memory protection, data 
fetching, and data storage. These functions are 
overlapped for quick instruction execution. 

Other features of the processor include : 

• Hardware for handling segmentation and paging 
in virtual memory 

• Hardware for interrupting a process in execution 
at any point (including in mid-execution of an in- 
struction), saving processor status, and restoring the 
process later without loss of continuity 

• High-speed cache memory for improved perform- 
ance 

• Hardware for enforcing several modes of memory 
access 

• Hardware for implementing data integrity and 
security mechanisms 

• AssiK-ialive memory for fast hardware access lo 
virtual memory 

• Program-addressable registers for preparing virtual 
memory addresses 



Processor Organization 

The Multics processor module is organized aroimd 
functional units 

• Control Unit prrwidc* the mterface between 
the C>peratjonii Unit and tlic nyilcm controllers 

• OperatUms Unit Contains the logic to execute 
binary arithmetic and logical functions 

• Decimal Unit - includes an Extended Instruction 
Set (EIS) within the processor's basic repertoire of 
instructions, including instructions for processing 
character string, decimal data, and bit strings 

• Appending Unit - implements segmentation and 
paging of the virtual memory; provides 24-bit ad- 
dressing; contains 1 6 segment uescnptor worus anu 
16 page table words on a most recently used basis; 
and provides a descriptor segment base register, 
eight segment pointer registers, and ring protection 
hardware 

• Cache Memory Unit ~ holds the most recently 
used information from main memory and improves 
system performance by reducing instruction and 
data fetch time 

Processor Modes of Operation 

The processor operates in three modes: absolute, 
privileged, and nonprivileged. All instructions are 
available in the absolute mode. Privileged instruc- 
tions, such as those that operate on the descriptor 
base register and input/output devices, are avail- 
able only in absolute and privileged modes. Most, 
but not all, of the instructions are available in non- 
privileged mode. General users are restricted to the 
nonprivileged mode and thus are prevented from 
executing any instructions that could interfere with 
other programs or with the Multics system software. 

The full segmentation and paging capability of the 
processor is used in the privileged and nonprivileged 
modes for fetching instructions and operands. Ad- 
dressing in the absolute mode does not use the seg- 
mentation and paging capability and is not generally 
available to user programs. 

Segmentation 

Segmentation divides the user's address space into 
many parts and assigns attributes (access control 
and length, for example) to these parts based on 
their logical use. Like a conventional file, a Multics 
segment is a collection of instructions or dala s|vc- 
illed by the user. It has a symbolic name and access 
control list and can vary in length. A segnKMil can 
be addressed directly, as memory can, and does not 
have to be read or written record-by-record as a 
conventional file would. 

The segment is the basic unit of information shar- 
ing. Different users can incorporate a single segment 
into their programs merely by specifying the sedi- 
ment name. A program doesn't need to copy a seg- 
ment to use it, saving time and eliminating dupli- 
cation in main menuiry. To control tliis sharing. 
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eacn segment has an access control list containing 
the name and access privileges of each person who 
can use the segment. The hardware checks these 
access privileges on each reference to a segment by 
any user. 

Certain segments, containing only instructions 
or constants, are especially easy to use and 
efficient in occupying storage space. These "pure- 
procedure" segments store their data and control 
variables separately. Pure procedure segments do 
not modify themselves; they are also totally re- 
entrant. More than one user can use the same re- 
entrant procedure simultaneously without having 
to copy it. This enhances sharing and saves storage 
space. The Multics operating system, compilere, 
and application programs all utilize pure procedure. 
The major benefits of segmentation are: 

• Stored data and procedures can be referenced 
easily and directly 

• Logical units such as programs and data are pro- 
tected by hardware 

• Users can directly share procedures and data 

bases 

Paging 

Segments can be of different sizes, and their sizes 
can change during the operation of a program. In 
order to simphfy allocation of main memory, each : 
segment is divided automatically into fixed-size 
storage units called pages. This division - and the 
subsequent manipulation of the pages - is totally 
transparent to the user and requires no action on 
the user's part. In addition, any access controls 
established for a segment apply to the pages that 
make up that segment. 

Tlie pages of a given segment need not be located 
in contiguous storage blocks. They do not even have 
to be in main memory all at once. As a page is 
needed in main memory, it is retrieved automat- 
ically from secondary storage and placed in any 
available block in main memory. When main mem- 
ory is filled and more pages are needed, some pages 
have to be displaced. Pages not used recently will 
be moved (swapped) to secondary storage. (For 
added system efficiency, pages that are part of a 
pure-procedure segment or have never been written 
mto do not have to be swapped out, since a copy 
still exists in secondary storage. These blocks of 
memory can simply be cleared and overwritten 
with other pages.) 

Paging has distinct advantages: 

• A user can write and operate a program without 
planning for its storage allocation needs or for the 
management of the segments. 

• Paging provides a simplified technique for dy- 
namic storage management and reduces operating 
system overhead by allowing optimum loading of 
main memory and avoiding compaction problems. 



• Paging uses the system's high-speed storage ef- 
fectively by fetching only pages that are actually 
referenced, rather than an entire program or file. 
Ring Structure 

The Level 68/DPS ring structure extends the con- 
cept of a two-state machine (i.e., master-mode and 
siave-mode) to a multi-state machine. Level 68/DPS 
provides eight states of execution with adequate 
tools to allow proper administration of access privi- 
leges to the system users within them. This imple- 
mentation allows segments to be grouped into rings. 
Tlie number of each ring (0-7) designates the level 
of pnvilege assigned to procedure segments executed 
m that nng. Ring has the highest level of privilege. 
Privileged ring segments, such as the supervisor and 
speaal user subsystems, are protected from uncon- 
trolled use by less privileged rings. These segments 
can only be used by procedures in less privileged 
nngs if called via a special "gate" mechanism. The 
access permission checking is still required as well. 
The ring structure, with its obvious applications to 
information protection and security, is an integral 
part of the paging and segmentation hardware. The 
ring structure offers users numerous benefits, for 
example: 

• Users can create protected programs and data 
bases for controlled use by others 

• A supervisor program can be implemented in 
layers with differing degrees of privilege 

• A programmer can debug a program in an unpriv- 
ileged environment and then move it to a privileged 
environment with no recompilation or modification 

SYSTEM CONTROL UNIT 

The system control unit (SCU) is the principal inter- 
face between all central system components. It pro- 
vides complete system interrupt control which 
regulates communication between components and 
services all demands on memory under priority con- 
trol. The system control unit handles the switching 
of all control signals, addresses, and data into and 
out of the memory units. Memory units are modular 
and each connects directly to a system control unit. 
Up to eight system control units may be configured 
m a Uvel 68/DPS system, with each SCU capable 
of controlling one mega word (four megabytes) of 
memory. However, note that maximum memory 
size currently available is four megabytes. 
Additionally, the SCU checks integrity on all data 
and control paths to and from memory units as 
well as the paths to and from the other system 
components. It also provides memory configuration 
switching. 

Tlie system clock within the SCU a 52-hil binary 
counter that increments at onc-micro»ccond iniiT- 
vals is used as a calendar clock, Tlie 142-ycar 
capacity of the clock makes it possible for Mutlics 
software to operate on a consistent time base. 
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MEMORY 

The metal-oxide semiconductor (MOS) memory of 
the Level 68/nPS Systems can range from 5 1 2K 
words to four milHon words. Two words, plus Frror 
Oetectioti »ml ( otfectioti (FDACj HiN, afe iicce«*»ft 
jti ¥m:h hi^mtm fV»lt* 

»NPUr /OUTPUT MULTIPLtXfcB 

Tlie input/output multiplexer (iOM) interfaces the 
system control units with the peripheral units and 
integrated network processors. The IOM can operate 
many different types of devices. It is controlled by 
information stored in memory. 

The IOM can transfer data between I/O devices and 
memory while processors continue to run programs. 
I/O transactions are controlled by lists of control 
words prepared by the Multics operating system and 
stored in memory. When an I/O transaction is com- 
plete, or when special conditions are detected, the 
IOM causes a program interrupt. 

The IOM has attractive performance characteristics: 

• Peak IOM transfer rate of more than four million 
bytes per second 

• Up to 56 simultaneously active data channels per 

• Peak channel transfer rates of more than one 
million bytes per second 

• Scratchpad storage for control words 

• Eight special channels for specific system functions 

The IOM offers complete memory protection for 
all I/O data transfers. Each data channel functions 
independently, with its own memory assignment. 
Parity is generated and checked on all information 
sent to and from the system controllers and the 
peripheral subsystems. 

PERIPHERAL SUBSYSTEMS 

The Level 68/DPS mass storage subsystem uses the 
freestanding MSP0603 mass storage processor to 
control up to 32 mass storage units. Multiple mass 
storage subsystems can extend the virtual memory 
size to a maximum of 512 mass storage units. Three 
different devices are supported; the MSU0402 
(78 megabytes), MSU0451 (157 megabytes), and 
the MSU0500 (626 megabytes). These devices can 
be intermixed on the same mass storage processor. 

The MTP0601 Magnetic Tape Processor supports 
the MTU0400, MTU0500, and MTU0600 tape 
units. These devices range up to 200 inches per 
second and 1 600 bits per inch. Other peripherals 
include the PRU 1 1 00/ 1 200/ 1 600 ASCII line 
printers ( 1 1 00, 1200, and 1600 lines per minute, . 
respectively), 1050-card-per-minute readers, and 
100- to 400-card-per-minute punches, all undier the 
control of the Unit Record Processor (URP). Up to 
eight individual devices can be controlled by a 
single URP. 



NETWORK PROCESSOR 

The Integrated Network Processor (INP) controls 
all remote terminal interaction with Level 68/PPS 
host system. Connected to the central system vi;i 
an IOM, the Integrated Network Processor provides 
th*" ^^Hnm mittfm^n ferittired by the elrntpfih nn*! 
j.iMlin hN Hf ft tlhfMtiHf*»*f s^Mi^fH rt** W»il) «*» k IfH IM**' 

tui UMiuii With iii«» iiMM h^mm Hy iit^iiuMMuig ih^ 

tasks of message management and message liandling, 
the INP frees the host for other processing functions. 
The resources of the central system are called upon 
only when the message is submitted for information 
processing. However, some networking functions 
(e.g., a message switch) can be accommodated by 

♦ho IMP unth'^nt nnv invnlvfttnent of the host 

processor. 

TERMINALS SUPPORTED 

Level 68/DPS systems can communicate with var- 
ious types of terminals, Including the following: 

Interactive Devices 

Honeywell VIP 7105, 7205, 7705, and 7800 
Teletype Models 33, 35, 37, 38, and 40 

IBM3270 

IBM2741 and 1050 (KBCDIC md Correspondence) 
IBM 1050 
IBM 2780 

Trendata Models 1000 and 4000 
Datel 30 
Dura 1021 

GE TermiNet 300 and 1 200 (up to 1 200 bps both 
half or full duplex) 
Execuport3lOCand320C 
Texas Instruments Silent 700 Series 
Adage Inc. Advanced Remote Display Station 
IMLAC PDS-ID Graphic Display Computer 
Tektronix (graphics devices to 9600 bps) 
DIGI-LogTelecomputer Model 109 
Data Products Portaconi 
GDmputer Devices Incorporated Teleterm 1030 
(including ASCII/ APL models) 1 132, 1203 
Teleray Model 3711 
DEC GT40 Display Processor, Dl-Cwriter 11. 

DECwriter LA36 (300 baud ASCII) 
DEC Graphics Models 1 2 and 1 5 
Hazeltine 2000 (ASCII) 
Delta Data Systems (Alphanumeric CRT up to 

2400 bps) 
Xerox 2700 (Diablo printer with plotting c:ip;ihility) 
Anderson-Jacobson Models AJ630 (ASCII), AJ832. 
and AJ841 

Gen Com Systems GSI300 (300 baud ASCI!) and 
CSC 300Q 

Lear-Siegler AI)M-2 Display Terminal 
ADDS Consul Model 980 
DTC300 Series 
Infoton Vistar/I! 
Bedford 575 (Selecterm) 
Bee Hive Super Bee 
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Remote Job Entry Devices 

Absentee (batch) prpcessing is supported at the 
central site and at remote sites. Remote batch ter- 
mmals such as the Honeywell Model GI 15, Data 
100/78 (using Honeywell Model Gl 15), RNP702 
IBM 2780, Honeywell Level 6, and Mohawk 240() 
oiler remote bulk I/O capability and remote job ' 
entry. 

RECONFIGURATION 

The memory modules, central processoi^, mass 
storage devices, and terminals in a 68/DPS system 
can be reconfigured dynamically, without inter- 
rupting user service. This allows failing devices to 
be removed from processing for maintenance and 
reconfigured automatically following repair. In 
addition, failing memory pages are automatically 
deallocated whenever a double-bit (uncorrectable) 
error is discovered. Urge configurations can also 
be split into smaller separate systems for block 
time processing or testing without service shutdown. 

SYSTEM CONFIGURATIONS 

System configurations can be tailored to user 
requirements. An entry-level configuration consists 
01 : 

A Level 68/DPS System Control Unit with 51 2K 

words of memory 

An Input/Output Mulfiplexer 



An Integrated Network Processor 
An MTP0601 Magnetic Tape Processor with a mini- 
mum of two MTU0500 tape units 

^.!f^!^^^^ ^''''' ^^^^^g^^ Processor with (wo 
MSU0402 Mass Storage Units providing 156 mil- 
lion bytes of storage 
A printer 

An operator console 
A full selection of terminals 

The system can be significantly expanded to a maxi- 
mum complement of equipment: 

Level 68/DPS with power options to 4.3 times proc- 
essing power of entry systems 
8 System Control Units with a total of four niillion 
words of memory 
2 Input/Output Multiplexers 
4 Integrated Network Processors 
32 MSP0603 Mass Storage Processors and 5P 
MSU0500 Mass Storage Units providing 300 bil- 
lion bytes of storage 

MTP0601 Magnetic Tape Processor and 16 
MTU0600 Magnetic Tape Units (per subsystem) 
8 unit macro devices (per subsystem) 
An operator console 
A full selection of terminals 



Specifications may change as design improvements a 



are introduced. 



MAXIMUM CONFIGURATION 



DUAL PROCESSING 
UNIT 



DUAL PROCESSING ADDITIONAL 

UNIT PROCESSING UNIT 




PERIPHERAL SUBSYSTEM: 4 NETWORK PROCESSORS (96 LINES FACH) 

^« nMli°t?P ^^^^ '^'^'"^S PER SUBSYSTEM 
8 UNIT RECORD PERIPHERALS PER SUBSYSTEM 
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Distributed Processing 
System: Multics Overview 



Multics, one ol Iho most powcrlul iiiui comprehen- 
sive laifio-scale sysloms in the world lochiy, provides 
genei;il purpose (hit.i processing service for users 
iie;iling with chullenging busmessund scientific 
problems. B;ised on the concept that the computer 
is only as productive as it is accessible, Multics offers 
a broad range ol features and capabilities within 
a service-orienled envnomnent and addresses the 
reliability, availability, and system growth ie(|uire- 
inents of distributed processing users. 

PROCIiSSING CAPABIUI lES 

Muhics is for large and small users ... experts and 
novices. Its total online, interactive orientation is 
ideally suited to a variety of processing activies in- 
cluding: 

BATCH Multics supports both local and remote 
batch processing. Interactive users can submit 
batch jobs lor execution; batch jobs can also ini- 
tiate other batch jobs, .lobs written for batch exe- 
eution can also be run interactively without change. 
Rl'-M()r[< JOB imRY Multics .supports num- 
erous devices lor remote Job entry. Hiese include: 
Mohawk Data Sciences 2400, DAI'A 100 Model 78, 
IBM 2780, Honeywell Model G-1 15, Honeywell 
RNP702, and several Honeywell level 6 models. 
TIM!' SHARINC; Full time sharing capabilities 
are available on native mode, interactive Multics. 
In addition, two other environments, the Multics 
FAST and DFAS I subsystems, provide the user 
with varying levels o\' time sharing power and proc- 
essing performance. 

TRANSACTION PROCT-SSING Multics trans- 
action processing offers Hexibilily and scope un- 
matched in other systems. Terminal oriented, the 
system (Uvsirt require special executive programs 
to monitor terminal inpni ;ind then to process user 
requests in batch. Applications can be written in 
'iiiy iangiMge ami directly acc.ssetl frc>m anv number 
t)t termmalsor batch jobs ... simultaneously ... in 
a compietelv shared enviriMiniefi;. System facilities 
billow interlaces to speciali/ed data bases as well as 
eoncmreiil access control, lomnali/ation, recovery, 
ami online forms geneiadon. 



WORD PROCTSSiNG Multics^ advanced wonl 
processing facilities include: 

• F*()werful text editors 

• Document formatting capabilities 

• I'rror detection tools 

• SI>|{b;D'rYPi: (shorthand lor typists) 

• Online dictionaries 

• Artwork macros 

• Flectronic mail 

rogelher, these features enable the Multics user to 
create and maintain error-free documents and pro- 
duce formatted output. 

GRAPHIC PROCESSING A genera! purpose inter- 
tace enables user and application programs to create, 
edit, store, display, and animate graphic material. 
Multics' graphic features include: 

• Terminal independence 

• Powerful editing capabilities 

• Permanent storage capabilities 

• Sharing subobjects and structures 

• Dynamic animation 

• Local editing 

• Incremental picture updating 

Rb:ALTiMb PRO( !:SSING Multics can provide 
real-time response to specified users or jobs (dead- 
line job scheduling, for example). 1 bus. the system 
is useful in operations control functions such as 
process control monitoring. 

USER ORIENTATION 

Uniform User Interface 

Key among Multics' unparalleled accessibility 
leatures is its uniform user interface. All the system's 
processing functions from batch to time sharing to 
graphics are available via a single, consistent 
interlace. There are no format or execution differ- 
ences between usage types. A program written in an 
interactive environment will run in batch wil/ioi/f 
conversion or nitxlifica/io/i. ami vice veisa. Any 
ierminal attached to the system can, unless specili 
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cally restricted by the system's administrators, 
access any program or feature. 
Also implicit in the Multics environment is the con- 
cept of total compatibility. There are no restrictions 
on languages used to access data bases or files. Pro- 
grammers can develop COBOL applications, for 
example, with certain modules written in other lan- 
guages, and be assured of total compatibility and 
cciual processing efficiency. Moreover, data and pro- 
grams associated with one processing dimension 
(e.g., transaction processing) are totally accessible 
from any other dimension. 

Total Oniine Orientation 

Multics' architecture is oriented directly toward on- 
Une appHcations. Whereas other systems provide 
online capabilities through executive packages, 
Muhics is completely interactive, and does not use 
such packages. As a result, in high-volume trans- 
action-oriented environments where there is sig- 
nificant terminal activity, Muhics provides unique 
advantages over other architectures. 

Total Sharing 

Multics permits the controlled sharing of operating 
system software and libraries, language processors, 
data bases, and user code and data. Even with mul- 
tiple users simultaneously compiling COBOL jobs, 
for example, only one copy of the COBOL compiler 
is in use. And since all Multics language processors 
generate reentrant code, even users' programs can 
be shared without special programming. 

EASE OF USE 

From its inception, Multics has incorporated features 
and capabilities that make it one of the most acces- 
sible and easy-to-use systems on the market today. 

Interactive Orientation of All Facilities 

Every aspect of Multics is onhne-oriented, including 
the language processors, applications, data base man- 
agement facilities, utiHties, administrative tools, and 
metering and tuning capabilities. 

No Job Control Language 

Unlike other systems - which require that the user 
learn a job control language (JCL) prior to running 
a job Multics provides control functions via a 
standard command processor approach, thus elim- 
inating complex JCL. System commands and rou- 
tines supply the logical branching, conditional exe- 
cution, file system, and 1/0 control required to 
direct a job through simple and complex execution 
paths. Thus, the Multics user need not learn a new 



batch interface, or become a JCL expert to use the 
system for problem solving. 

Flexible Environment Shaping 

Multics matches the computer's processing environ- 
ment with the user's particular needs. Providing a 
nexible interface, Multics enables users to continue 
using the computer in the way they are accustomed 
even though they are changing to a new system. 
The concept of shaping environments is particu- 
larly beneficial for data processing organizations 
that service many diverse user groups simultane- 
ously. Each group can develop - using standard 
administrative tools speciali7.ed interfaces to 
satisfy uniqvue operating requirements. Typical ot 
these tools is the special command processor with 
which users can define their own abbreviations for 
frequently-used command lines or sequences of 
commands, as required. 

EXEC-COM Facility 

With this feature, users can write programs to exe- 
cute stacked command lines. The additional control 
capabilities provided by the KXECX^OM facility 
allow for logical branching, the maintenance of 
variables, command-level I/O, and conditional exe- 
cution. Thus, it is possible to develop routines 
for functions which typically require higher level 
languages without having to actually use such 
languages. 

Help Files 

Multics help files contain printed text which pro- 
vides immediate, online assistance to users request- 
ing data on various system topics, including the use 
of Multics commands and subroutines. Tutorials on 
each system feature are thus readily available. Sim- 
ilarly, users can document their own programs and 
routines, and avoid continuous referral to cumber- 
some hard-copy documentation. 

Memo Facility 

The memo facility allows users to indicate when 
specified events are to occur on the system. Events 
to be scheduled can be inter-job signals, mes.sages, 
or program executions. Typical examples include 
simple date reminders and the automatic scheduling 
of an installation's batch applications. 

Intelligent Defaults 

Multics - via its intelligent defaults lets users per- 
form certain functions on the system without having 
to consider concepts that do not pertain to (heir 
particular application. In a typical situation where 
the user wisiies to archive data on tape, numerous 
details such as tape density and blocking lacliu-s 
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must also be defined. For users to whom these de- 
tails are not relevant, Multics standard defaults per- 
mit the archive tape to be written via simplified 
I/O routines from command level. 

VIRTUAL MEMORY 

The Muitics virtual memory miplemenlalion, totally 
!nvis!()k' to user proLManis mmnmis (IkiI pso^rammers 
can concentrate on prolileni soiviiij- r.iMu'r than be 
concerned with real memory constiaints and mem- 
ory management (e.g., partitions and overlays). 

Virtual memory is limited only by the amount of 
available mass storage. So, programs written for the 
largest configuratit)n can run on the smallest without 
modification. No standard, fixed main memory-to- 
mass storage ratio is recpiired to ensure efficient 
system operation. Regardless ol the ratio, Multics 
can be tuned to perform within its real memory 
constraints. 

Segmentation 

Multics organizes inl\)rmation into segments 
logical, namcil units contaimng data, programs, or 
directories of other segments. The segilients and 
their directories form a uniform file system for all 
users, the administrative and accounting system, and 
the system software itself. Segments can increase 
dynanncally up to I megabyte in length, and files 
can span nearly 1000 segments. 

Paging 

Multics designers devised the paging concept to 
avoid tlie system performance limitations that re- 
sult from swapping large files (segments in the case 
of Multics) in and out of main memory. In Multics, 
segments are subdivided into "pages" (4096-byte 
blocks). Address mapping at the hartlware level 
enables the system to determine if the [xige of a 
requested segment is in mejuory and if not, to 
locate that page, transport it to memory, and 
schedule it lor execution by the waiting process. 
Demand paging eliminates space allocation and 
compaction problems and maximi/es system per- 
lormance. Paging is completely transparent to the 
; '■-" '"v'S^ c^'Ia^s iLviiiiifo lor me execu- 
tion of a program are brought imo memory at any 
given time. 

I he actual movement c)l inlormation in and out of 
main memory is completely automatic and trans- 
parent. Data required by the user, lor computation 
or mampulalion, is retrieved from peripheral storage 
and inscria' in m;nn memory without Ijie user ever 
knowing llie tiaiisie: look place. 



PROGRAM DEVELOPMENT 

Multics ranks as one of the industry's premiere soft- 
ware development tools. It has powerful source code 
manipulation techniques for entering, editing, and 
archiving code, and for automatically structuring 
programs for easy reading and use. Its online debug- 
ging tools lacilitate checking out new code, and aid 
in the fme lumng o! programs. Multics alsv) provides 
options lo! ilynamic linking or prelinknig o\' pro- 
grams, and standard calling sequences for system 
libraries and user programs. 

Multics' fully compatible language processors sig- 
nificantly contribute to the system's outstanding 
program development capability. These processors 
including PL/I, ( OB()L-74, FORTRAN, APL, Al,M 
(assembler), and BASIC^ can be fully shared. Be- 
cause of their compatibility, programs written in 
APL, for example, can call those written in PL/I 
or FORTRAN. Compatibility is restricted only 
by the data types supported by each language. And 
since all Multics compilers generate reentrant code 
by default, all user programs are shared; no special 
coding procedures are recpiired. 

APPLICATIONS DEVELOPMENT 

During applications development, the programmer 
typically must address concerns such as tenninal 
control, data base nfanagement, interfaces to system 
functions, data security and integrity, and I/O inter- 
faces. Multics provides a standard applications envi- 
ronment that can be shaped to individual needs. 
Thus, progranmiers can avoid these problems and 
concentrate on programming, thereby significantly 
shortening the development cycle. 

DATA BASE MANAGEMENT 

The Multics Data Base Manager (MDBM) offers two 
data base management interfaces: Multics Integrated 
Data Store (MIDS), a subset of I-D-S/ILand Multics 
Relational Data Store (MRDS). MIDS supports 
schema/subschema data base definitions to provide 
data and program independence. Data base struc- 
tures which can be developed include secpiential, 
network, hierarchical, or cyclical. MRDS provides 
data and program independence via model/submodel 
data base definitions and nonprocedural user retrieval 
and update mechanisms. Both interfaces allow inter- 
active or batch usage, sharing, concurrent access, and 
access via programs written in any language available 
on Multics. 

ADMINISTRATIVE CONTROL 

A significant strength of Multics is its ability lo jno- 
vide service to a wide variety of users simultaneouslv 
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without the workload of any one group adversely 
affecting that of another. Multics' comprehensive 
set of administrative controls make this high level 
of processing service possible. These controls include: 

• Decentralized control options 

• Guaranteed resource allocations 

• Priority scheduling with specifix^d response char- 
acteristics 

• Deadline job scheduling 

• Flexible service pricing 

• Automatic or on-demand billing 

• Automatic user or project cut-off when resources 
are expended 

• Online metering and tuning 

• Standard environment shaping 

EASE OF OPERATION 

The operational features in Multics make its utility- 
grade service readily available to a wide variety of 
users. For example, there is no system or library 
generation or edit. The operator can start the system 
simply by typing one command at the console. 
System software and libraries - delivered patch- 

application can be added without shutting the sys- 
tem down, and with only one command, new soft- 
ware can be installed without affecting users working 
with other existing packages. 

Multics can run unattended. An automatic reboot 
feature automatically restarts the system in the 
event of a failure. The system's online test and diag- 
nostic capabilities permit the user to check out a 
malfunctioning component online, remove it from 
service if necessary, and dynamically reconfigure 
the remaining system components ... all without 
interrupting user service. 

I'ile integrity is fundamental in a service-oriented 
environment. Multics offers automatic mechanisms 
which optionally journalize recent file updates 
within the system's virtual memory. Should a fail- 
ure cause temporary loss of data, these journals can 
be reloaded to continue service. Duplicate file copies 
are not necessary since Multics itself provides file 
backup. 

Additional ease-of-operation features include: 

• Onhne administration and billing 

• Operation from any terminal 

• Dynamic control of the priority scheduler 

COMPATIBILITY WITH LEVEL 66 

Level 66 and Level 68/DPS systems share a high 
degree of compatibility. In their respective hard- 
ware configurations, only the central processors 



differ. The Multics central processor is a superset of 
the Level 66 unit and has a switch which allows it 
to run Level 66 GCOS, thus providing users of both 
systems added flexibility and backup. 

A special Multics subsystem called the GCOS En- 
vironment, allows GCOS job decks or IMCVs to be 
run without change. GCOS files can also be trans- 
ferred between the two systems using standard 
GCOS tapes. 

Multics, through the GCOS Environment, also sup- 
ports several languages that run under GCOS, includ- 
ing JOVLAL, ALGOL, COBOL-68, GMAP, and 
FORTRAN-Y. 

DISTRIBUTED SYSTEMS ORIENTATION 

Multics is ideally suited to the development of net- 
works of distributed mainframe systems. With exist- 
ing hardware and software, Multics can be intercon- 
nected with a variety of other systems to form 
networks, that address a broad range of user re- 
quirements. 

With this approach, users establish networks in which 
files, programs, and data can be shared among the 
various systems easily and with maximum security. 
For example, a programmer could log onto an 
IBM 370/158, and then have required data trans- 
mitted from a CDC-7600 to a Multics system for 
processing, with the output going to the 370. Num- 
erous variations of this approach are possible. In 
fact, Multics can currently interface with systems 
such as IBM 360 /370s, Burroughs 4700 and 6700s, 
CDC Cybers, and Univac 1 100/90s. 

SECURITY 

Multics offers high levels of security unattainable 
on other systems today. Several elements cooperate 
to make this outstanding system, data, and program 
protection possible. These elements are passwords, 
access control lists, multistate ring protection mech- 
anisms, and access isolation methods. No special 
coding is required to make use of any of these ele- 
ments; only standard system commands need be 
executed. 

Passwords 

The Multics password mechanisms control access to 
the system and verify users' identities. Each user 
has a system-maintained password which can be 
changed at any log-on. Passwords are stored in en- 
crypted form so that a user's password will not be 
revealed accidentally. When the user attempts to 
log on the system, the typetl in passworil is en- 
crypted and verified by comparison against the one 
storeci in tlie system. Precautions aie taken lo en- 
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sure that passwords are not exposed during the log- 
on sequence. 

Access Control Mechanisms 

An Access Control List (ACL) is used to control 
access to every segment in tiie storage system. 
Through the A( L users can grant specilic access 
rights (e.g., lead, write, execute) to individuals or 
groups of users. System hardware enlbrces access 
control during the execution of each individual 
machine instruction. 

Ring Protection 

A special hardware implementation, the Multics 
ring stnicture is a multilevel approach to data and 
program access control. The ring structure contains 
eight levels of execution (rings through 7; being 
most privileged, and 7 the least). Within this struc- 
ture, users can access information only in those 
segments at the same level or higher (less privi- 
leged) than the current state in which they are 
executing. The Multics operating system resides in 
the most privileged ring (0) while users generally 
execute in the less privileged rings. 

Access Isolation Mechanism 

The Access Isolation Mechanism (AIM) incorporates 
administrative controls to grant or deny access to 
information in the data base. AIM is a way of organ- 
izing users into groups among which communication 
can be restricted or denied. Like all other types of 
Multics access control, AIM is initially verified by 



Multics software and is hardware-enforced at every 
reference thereafter. However, AIM also can prevent 
users from granting - to other users access to 
even their own information. AIM can be invoketl or 
disabled at the discretion of each Multics site. In 
addition to administrative controls, AIM provitles 
extensive security auditing controls to monitor user 
activity. 

GROWTH 

Like other Honeywell systems, Multics' hardware 
architecture provides the benefits of modularity 
and an easy, paced growth that does not require 
swapouts to upgrade to higher performance levels. 
This easy expansion allows a user to configure the 
exact system needed and protects equipment 
investment. It is not necessary to change the oper- 
ating system, system libraries, or user codes in 
order to move to a more powerful Multics system. 

SAMPLE SYSTEM REQUIREMENTS 

A typical entry-level Multics configuration consists 
of the following components: 

• Central System, with 5 1 2K words of memory 
(2 million bytes) 

• One System Control Unit 

• One Input/Output Multiplexer 

• One Integrated Network Processor 

• Two MSU0402 Mass Storage Units 

• A minimum of two MTU0500 Magnetic Tape 
Units 
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LEVEL 68 



Multics Virtual Memory 
and Storage System 



I he MiiKics Sloni.m' SyskMU is ii iiKxIiiliir, liicrar- 
clucul lilo system mignictilal hy a comprohensive 
virliKiJ iiRMiiory. An iiilogral compoiiLMit of the 
Multics OpcM-iiling System, the storage system is 
just another reason why Honeywell helieves Multics 
to he the most advanced computer system available. 

HIERARCHICAL STORAGE SYSTEM 

In the Multics System, all information is grouped 
into segments, collections of instructions and/or 
data associated with a particular name. All ol the 
segments are slt)red m a tree slructmed hierarchy 
(see illustration), the beginnmg i)r which is called 
tlic root. The branches emanating Irom the root 
lead to cither nondirectory or directory segments. 

Ihe Directory C onccpt 

I he sole Junction ola directory segment is to 
catalog the segments residing below it in the tree, 
l-ach directory contains the names ol the subor- 
dinate segments and lists their attributes including 
length, virtual memory address, date and time the 
segment was created, list of users allowed to access 
the segment and with what access mode (read, 
write, execute, or null). 

The directory concept is the key to several Multics 
features, including storage structure, administrative 
control, access control, search rules, and naming 
conventions, lor example, all users registered on 
the system are grouped into projects. |{ach project 
has a directory, and each user in that project has 
his own directory subordinate to the project direc- 
tory. A user may create additional subordinate 
directories under his own directory or under direc- 
tories to which he has been granted specific access 
lie may also create -jjuks" in his diieclory to se- 
nients to which he has specific access ! lijs ca-Vi-^ 
hility is ollen used to share data and/or programs. 

Ihc Scgmen(a<i(>n Concept 

All information witliin the storage system is stored 
m the form of segments. Provided the user has the 
j>roper access rights, all inlormation is directly 
addressable. In addition, all of the information 
within (he storage system is placed within tiie 
Multics Knig Sliuclurc (see '^Controlled Access 
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to Segments") a hardware-software feature that 
provices maximum security over inlormation 
sharing. 

Each segment is identified by a user-assigned sym- 
bolic name (making use of the full ASCII character 
set) as well as by a unique, system-assigned iden- 
tilication. 

riie fully siuvified name of any one segment is the 
list of subnames that reflect that segmenCs posi- 
tion in the directory hierarchy with respect to the 
root directory. This name, called a pathname, 
shows the "path" from the root directory to the 
specific segment and is the symbolic name by 
wiiich tiie user must reference the segment. 

VIRTUAL MEMORY ENVIRONMENT 

Segmentation 

In the Multics System, all segments are diiei tly 
addressable by the hardware. With the addivssinj- 
scheme used in the Multics processor, all leleieiices 
to information are ma|>ped through descriptors 
(Segment Descriptor Words), riiese (lescri|itors 
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are listed in a table (Descriptor Segment Table) 
that identifies segment attributes and defines the 
access a user can have to the segments. Most 
importantly, segmentation encourages users to 
view memory as a collection of independent linear 
core memories, each associated with a descriptor. 
A user program can create a segment by issuing a 
call to the system specifying as arguments the 
symbolic name of the segment plus additional 
inlbrmation about who may or may not access this 
segment. Then the system constructs a descriptor 
according to the access information given by the 
originator of the segment. 
The originator has control over every segment in 
his directory; he can grant or restrict access to 
these segments in any way he chooses. In fact, he 
can grant difterent access privileges (read, write, 
execute, or null) to different users of the same 
segment. 

Once the segment is created, the user program can 
address any item within the segment u^'mg name, i 
where "name" is the symbolic name of the seg- 
ment and "i" denotes the place of the desired Item 
within the segment. The maximum segment si/.e is 
25(vk; vvords ( 1 ,048,576 bytes). 

Paging 

With most computer systems, the limiting physical 
resource is main memory. The amount of main 
memory online is a inajor factor in determining the 
performance of a system. The problems associated 
with "swapping" large files into and out of^main 
memory severely limit system performance. Even if 
files were not all large, there would still remain the 
difficult problem of core management. Since the 
Multics System allows users to create and/or 
manipulate large segments, it is neither feasible nor 
desirable to have an entire segment in main mem- 
ory when in use. 

Therelbre, in the Multics System, segments are 
automatically subdivided by hardware into "pages" 
with a fixed size of 1024 words. Additional address 
mapping at the hardware level allows the system to 
determine whether or not a page of a referenced 
segment is in main memory. 
If the page is not in main memory, a missing page 
exception occurs (called a "page fault"). The 
software system intervenes at this point and proc- 
esses the page fault by locating the desired page in 
the storage system and transferririg it into main 
memory. During this phase, the process that gen- 
erated the page lault relinciuishes control of the 
processor and the system dispatches the execution 
o^ another process (process multiplexing). Once 



the page does arrive in main memory, the system 
notifies the "waited" process and schedules it for 
continued execution. 

By using this "demand paging" technique witli a 
fixed page size, space allocation problems are sim- 
plified, and the cost performance factor of the 
system is significantly enhanced: only those seg- 
ment pages that are currently needed are in 
memory at any one time. 

USER ACCESS 

Direct Access to Files 

With m.ost large-scale computer systems, the pro- 
grammer must interface with the file system 
througli complicated Job Control Language (.KM.). 
He also must know the specifications of the storage 
device on which his files reside and must issue and 
control (either explicitly or through macro specifi- 
cation) his own I/O requests. 
The Multics System, with the aid of the virtual 
memory, requires no .ICL, nor are users concerned 
with or even aware of where and on what 
devices their segments reside. Instead, users com- 
municate with the storage system by asking the 
system to make avaiial^ie to iliem a segmcnl wiliun 
their own virtual memory. 

Controlled Access to Segments 
Since all information is stored online in the Multics 
System and data can be accessed directly, access 
limits and controls are mandatory. The access con- 
trol mechanism in the Multics System is a highly 
sophisticated and reliable means for specifying the 
usage attributes o^ directories and other segments. 
There are two access control lists recogni/etl by t!ie 
system: one for directory segments, one for non- 
directory segments. These access control lists are 
carried in directory segments. 

Access modes for nondirectory segments are: 
read (r) data in the segiuent can be read 

write (w) data in the segment can be nu)dified 
execute (e) an executing process can transfer to, 

and execute instructions in, this 

segment 
null (n) access to segment is denied 

Access modes for directory segments are: 

status (s) the attributes of segments, direc- 
tories, and links contained in the 
directory c:m be obtained 

modify ( m) the attributes o{ existing segments, 
dneclories, and links conlamcd m 
the directory can be changed or 
deleted 
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append (a) new segments, directories, and links 

can be created in the directory 
null (n) access to directory is denied 

Access validation is checked and enlorced at the 
hardware level on each nieniory reference. lM)r 
example, if the originator ofj data base decides to 
grant access to some user, he can issue a Multics 
command specifying "read" access for that user, 
if that user is currently attempting to reference the 
data base, he is given access instantly. 

As a further control to accessing segments, the 
Multics System uses the King Structure. Ix)gjcally, 
the King Structure is eight concentric rings, each 
representing a different level of virtual memory 
access rights. The highest level of privilege is the 
imiermost ring, designated as ring zero; the outer- 
most is ring 7. r:ach ring is protected against uncon- 
trolled access by programs in any ring with a higher 
number designation and thus a lower level of privi- 
lege. The Multics ring-handling mechanism is 
enforced at the hardware level. 

USER INTERFACE 

In using the Multics Storage System, the user has 
two available interfaces. With the first, the ''com- 
mand level" interface, the user can create and/or 
manipulate segments residing in various user direc- 
tories. In many time-sharing operating systems, the 
command level interface issu[)porled by the 
piiysical editing of the '\-ommand" intc) various 
system tables in the operating system at system 
generation time. With this technique, the problems 
enccMinteied wliile trying to ex()aiid the repertoire 
ol the command language can be extreme. 
in the Multics System, however, there is no "com- 
mand language"; everything executed at Multics 
command level is simply an object program from a 
system directory. When a user types a command at 
his terminal (e.g., create xy/.), the system first 
interrogates the user's own directoiy to see if the 
"create" program exists. If so, that version is exe- 
cuted. If not, the Multics System searches a set of 
system/user-supplied directories (called Search 
Directories) for the "create" program. The user 
also has the ability of expanding the default search 
directories to include other directories (possibly 
common to a specific project). 

1 he .secoiul user interface is available via program 
execution. Users' object programs can issue call 



statements to create and/or manipulate segments. 
The call statements themselves are of the standard 
PL/I form. Any program executed while at Multics 
command level can be called and executed inter- 
nally from within an object program. 



FEATURES 

Various features of both the Multics Virtual Mem- 
ory and the Storage System are sununari/ed beUnv. 

• All information stored in the Multics Virtual 
Memory is directly addressable provided the user 
has proper access rights. 

• i'stablished protection rings allow users to elfec 
tively partition data within concentric ring struc- 
tures. 

• Iwo or more users can share a single copy of 
data and/or programs in main memory. 

• Users may create "links" to other accessible 
segments of virtual memory in order to share data 
and/or programs. 

• Each user can specify various access rights to his 
own segments, even specifying different access to 
different users of the same segment. 

• Movement of data between main memory and 
secondary storage and back is automatic, and is o\ 
no concern to the user. 

• 'Iree-slructured storage hierarchy offers an 
organized scheme of classification and facilitates 
efficient search for a particular segment. 

• Use of directories within the storage system 
serves as a convenient place to look up adtlresses 
and access rights of other segments. 

• Access rights to a segment are checked by 
Multics hardware on every reference to the seg- 
ment. 

• Multics has no Job (\)ntrol Language; everything 
executed at command level is merely a standard 
object segment. Thus, the "command language" 
can be dynamically developed, expanded, and 
tailored to individual installation even individual 
user requirements. 

SYSTEM CONFIGURATION 

The functions herein described are applicable 
to any Level 68 configuration. 
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LEVEL 68/DPS 



Administration and 
Operating Features 



The Level 68/D,stribu.cci Processing Sys,teni, with 
it. Mulfcs operating system, is an advanced arge- 

dTt,',r''""" ''""" """"''"8 g-^neral purpose 
cl-Ua^processmg se,^,cc lor business and scientific 

Level 68/l)PS adn.inistration and operating 
wilh'^mn!, r ''' T"'''"' capabilities avaifable 
Level 68/ )PS user more efficient control over 
onlme applications, improved response to individual 
u er and group needs, and optimal utilization of at 
processmg-related resources. 

INTERACTIVE ARCHITECTURE 

Level 68/DPS architecture is specifically directed 
toward nueractive, online applications. It p ovides 
conunon mierfaces for the implementation of these 
a well iT TvJ"' ""^'^^'''"'"i^'^^tion and control 
as well. In addition, special online executives are 

Level 68/UPS employs standard, built-in took for 
controlling the use of all system resources 

MODULAR GROWTH 

itsutersb"e''„'.n r'™' "f^^"^ '''""^'^^ modularity, 
iL frnin .°'" ' '°"« =°"fig"ration life span, 

Irte from disruptive programming or operational 
changes. Level 68/DPS offers growth in sm T^a ' 

wo loH n • ""'"-''' *"" ""-• 8™*"> "f «he u er' 
workload. Users can add more memory, new proc- 

o peeilic workloads. Level 68/DPS uniformity 

smallest configuration to the largest without 
changing „„, Multics operating sys'tem,Zarics 
or user programs. 

DECENTRALIZED ADMINISTRATION 

Lmidamenial in the level (,8/l)PS design is the 

-;.-,,, ha, productivity is tied directly ,0 accessi- 
bility. I he system s approach to administration is 
eo sis en, with that concepl. Level 68/DPS admin- 

oiblln ;'?."■"'"'''•-'" '"'" ^"'•'^''''^- ^'^^''"^ces 
an be all ocaled lospecillc projects and accounted 
lor accordingly. The project administra.or can in 



wi^in'lr" ""'' '"'''"""'' '° '"'Ji^'dual users 
within the project as necessary. 

in'thrir"ui'nf"/r "'"^ '"'^ "''' «™"P^ ""'"""-y 
conto Zwl '''•""• ""'' ™'"'''"S 'hem to 
Zitv o m n '■'"'" ''"'^'^' ^"''' 'hem the opp<,r- 
tunity to more eflectively deal with (heir day-, -<liv 
problems and varying processing rec,uiren,el„s ' 

oa°vei?8/DpVl"*"''^ '""''""'' '"^ «'^-"^'*^c 
hilli„„ ^*/'^''^*Jccen,ralized administration. This 
billing can be automatic or on demand. Users on 
individual projects can even do their own sub-billin. 
substitute their own billing algorithms, use dillb e U 
algonthms for different user., or install new 
algorithms dynamically. 

The Level 68/DPS administrator can establish up 
to eight separate work shifts, with different ra,es 
apphed o each, encouraging use during slack' 

RESOURCE UTILIZATION CONTROL 

Resource control in Level 68/DPS involves three 
w?«T "'"f °"''"^ ^'°"8e utilization, phy, , 
access to system communication lines, and u*r oh 

Online Storage Utilization 

Level 68/pPS enables an administrator to control 
»>e use of online storage on a "per project" a-^s 
To maximize the use of storage resoulce tht 

:^^: ?" ^"°-'^ "- ^'<'-«^- •" i-hvidual 
s TTii..,,, a project. 

Two techniques illustrate this control- 

• A storage quota, which prohibits the allocaliou 

rlche'r "'""' "'"" " """''"'' ''""''"■■•'' '""" '^ 

• An a,„oma,ic da,a migra,ion function, which 
lrtl-MVr^'''"''''1"''"''"^'""'''--^-'h''' 

iiiron;!;;::'''^'-^""'''^'^'"^'--'' '"'-■-'-• 
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Physical Access 

Controlling the physical access to Level 68/DPS, 
which includes restricting user groups to specified 
communications lines, also means controlling the 
workload mix on the system. The administrator 
can establish the maximum work units that the 
system will aclciiuately support for the particular 
site. Issuing load unit weighting factors for each 
user ensures that the system's capacity cannot be 
exceeded to the detriment of its users. Different 
users can be issued different weighting factors to 
retlect different processing requirements. To ensure 
that specified privileged or high priority jobs will 

„i r, u,> <,v,^,.,i+o/1 r«(T'irri1«^cc nf th(» tO^^I WOrk- 

load on the system, certain users can be given 
guaranteed access status. 

User Job Prioritization 

Dynamic Scheduling 

User and job prioritization is accomplished via 
dynamic control of the priority scheduler. With 
this capability it is possible, for example, to add 
either more batch jobs or more interactive users to 
a system without negatively affecting the produc- 

processing activities already in execution. 

Workload Balancing 

Level 68/DPS also incorporates a workclass concept 
which further ensures that the workload of certain 
users will not negatively affect the workload of 
others. Users can be grouped into classes and allo- 
cated percentages of processing capability. Regard- 
less of the total system workload, each group of 
users can be ensured a predetermined percentage 
of available central processor time. "Free time," 
any time not utilized by a given workclass, is made 
available to other workclasses requiring more than 
their allocated time, maximizing central processor 
utilization. 

Deadline Scheduling 

This feature can be used for a limited number of 
users or applications to ensure that a predefined 
amount of processing time is available to these users 
after an interaction or job submission. Deadline 
scheduling ensures that batch jobs will finish within 
a specified time period, and that interactive users 
will receive a response within a predefined time 
span after a transaction, regardless o\' the overall 
system workload. 

Changes to allocated resources, response character- 
istics, and batch job scliedulingcan be accomplished 
dynamically, or scheduled to happen automatically 
at a predctcrnnned tinic. For example, a key appli- 
cation can be deadline scheduled so that it is 
ensured a four-second response time during prime 



shift, but only an eight-second response time on 
second shift. 

ENVIRONMENT SHAPING 

Level 68/DPS environment shaping tools lei you 
define interfaces to match users' application proc- 
essing needs. These tools not only make it possible 
for nonexperts to use 68/DPS for problem solving, 
but also enable system administrators to succinctly 
define and limit what users can do with the system 
and what they must know to process their 
apphcations. 
The two major environment shaping tools are the 

iimiieu selvicc suusysiv^m <m^> i'"- wi*^^^^ ...i.-..^ - 

• The limited service subsystem enables the project 
administrator to define exactly those functions 
which the user cannot perform; all other system 
functions are available to that user by default. 

• The closed subsystem lets the administrator 
define all the functions which the user can perform; 
all other functions are unavailable by default. 

The limited service and closed subsystems can also 
be used for defining new command languages and 
interfaces that convert "foreign" system comniaiuls 

-.-i... k4..i*:.... ^^.^,^^..4:.i.T d'cfitn-i <vtii')iii:in(K I lus call 
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be useful to first-time Level 68/DPS users. In atUli- 
tion, these subsystems allow nontechnical users to 
access the system via a highly simplified command 
interface. The capabilities afforded by these struc- 
tured interfaces do not have to be programmed; 
they can be established via simple commands. The 
administrator need only create a new file with the 
new restrictions or guidelines in it, and it is immedi- 
ately available to all authorized users. 

SIMPLIFIED SYSTEM OPERATION 

Level 68/DPS is surprisingly easy to operate, espe- 
cially considering its size and power. This relative 
ease of use is due largely to its dynamic reconfigura- 
tion capability, simplified system maintenance, and 
responsive online metering and tuning capabilities. 

Dynamic Reconfiguration 

The dynamic reconfiguration capability o( Level 
68/DPS is used to maintain continuity of processing 
service in the event of a malfunction in a system 
component. If a failure occurs in a processor, for 
example, a single command automatically moves 
iobs and data in that processor to another unit, 
notifies the other system components of the mal- 
function, removes the processor from service, ami 
reconfigures the remaining ilevices. Processors, 
memory, and peripheral devices can be added to or 
deleted from a configuration dynamically, via oivr 
.iitor command, failed pages of memory (4K-bytc 
units) are automatically reconfigured by tiie opei 
ating system whenever a double-bit error occurs. 
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TIlis reconfiguration process can also assist in tiic 
testing of certain components. Users can 
dynamically remove certain devices from service, 
submit them to test and diagnostic routines and ' 
reconfigure them automatically, without inter- 
rupting processing service. Alternatively, devices 
can be dropped from service on one system, con- 
figured as a separate system, used for testing of new 
software, and then reconfigured in the original 
system without shutting down service. 

Level 68/DPS can run unattended, providing oroc- 
essing service on holidays and weekends, without 
the need for operators. During unattended opera- 
tion, it can be run in the automatic reboot mode, 
and, in the event of a system failure, the system ' 
will automatically reinitialize itself so service can 
continue. 

Level 68/DPS can be operated from terminals inside 
or outside the computer room. Due largely to the 
system's extensive security, an administrator with 
the proper authority can log into the system and 
issue any command that could be issued from the 
main operator's console. This gives Level 68/DPS 
greater operational flexibility, and frees it from 
relying on a single device (which might fail) for 
control functions. 

Level 68/DPS provides batch job status and con- 
trol capabilities as well as communication between 
system users. Operations messages can be sent to 
individual users; messages can be broadcast to the 
entire user community or to those on a particular 
project (or vice versa). 

System Maintenance Features 

For simplified maintenance, the Multics operating 
system does not require system or library gener- 
ation or edit. Multics software releases are also 
delivered patch-free. 

Users can easily install their own software or 
add programs to the time sharing library. New 
software can be installed without a system shut- 
down or link-edit. New compilers, applications, 
and procedures can be installed without inter- 
rupting processing service, even while users are 
using old versions. 

Metering and Tuning System Performance 

Level 68/DPS offers standard metering and tuning 
tools that allow an administrator to monitor and 
adjust system performance according to specillc 
needs i\m\ changing workloads. Using data thai 
is constantly being gathered by the system itself, 
administrators can retune the system, move users 
from one processing class to another, or even 
change the percentage of processing power allo- 
cated to a user, depending on any number of 
variables and requirements. 



This control is possible because the administrator 
can analyze all facets of system performance from 
this constant flow of metering data. Some of the 
information supplied includes: 

• I/O and device activity data 

• Application response, processor utilization, 
communications, and I/O queuing 

• Average CPU time spent on certain functions, 
or used by certain applications 

• State and characteristics of the communications 
lines attached to the system 

• EDAC (Error Detection and Correction) data 
associated with main memory hardware erroi-s. 

PRESCHEDULED ADMINISTRATIVE 
FUNCTIONS 

A system facility called MI-MO provides gener- 
alized capabilities for scheduling tiie initiation ami 
execution of any program or set ofprogninis. Mils 
allows the administrative or operational staffs 
to pre-.schedule the running of administrative 
routines, such as billing. Scheduling can be sell- 
repeating, such as scheduling a program to he run 
every Monday at 3 p.m. MEMO also allows either 
a precise definition of day/date/time (down to a 
microsecond level) or more general, logical 
definition ("on Tuesday"). 

INTEGRITY MECHANISMS 

To maintain file integrity in the event of a mal- 
function. Level 68/DPS has powerful file back-up 
mechanisms. 

• An automatic file archiver journali/cs all 
changes to the file system atui makes it possible 
to "roll forward" following a failure. 

• Online file system integrity checks ensure a 
consistent, reliable tile system, 

• Main memory Hush-to-disk Is an automatic 
data protection mechanism invoked altera system 
service interruption. All data in main memory 
which has been modified is written out to mass 
storage to reflect all changes made up to the CH) 
cycles prior to the failure. 

• Support of optional "shadow copy" logical 
volumes within the storage system. Volumes 
designated to have shadow copies automatically 
have spare devices assigned with copies of each 
physical volume. When updates are made to any 
of these devices, the copy is updated as well. 

If a device fails, the system automatically shifts 
to the copy without u.ser interrupt. 
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Interactive Programming 

Environment 



To the user, a computer systtMn is only as produc- 
tive as it is accessible. Based on human engineering 
liesign concepts, the Level 68/Distributed Process- 
ing System (()8/l)I>S) uses interactive, remote ter- 
minal access the most natural and convenient 
mode tor the user - as the primary mode for 
programming. 

With the advent of Level 68/DPS, the computer is 
to be measured, not merely by hardware speeds, 
but by how well it helps solve a problem - from 
the very inception of that problem to its best solu- 
tion. Rather than wait for computer availability in 
a batch mode and submit many sequential jobs, a 
Level 68/l)PS user prepares, compiles, and checks 
out programs in one continuous interactive terminal 
session. 

The Level 68/l)PS interactive programming environ- 
ment provides a complete range of facilities that 
satistK^s both the novice user and the professional 
programmer. Both enjoy appropriate software tools 
and both can work on the same system, protected 
by advanced hardware/software security features. 
The Level 68/DPS user interface provides an envi- 
ronment for a nearly unlimited scope of applica- 
tions regardless of size, complexity, or storage 
requirements. The multiprocessing, multiprogram- 
ming capabilities of Level 68/DPS and its diversity 
of languages and utility routines provide the user 
with 'all the support needed. 

THE PROCESS, A UNIQUE CONCEPT 

When first accessing (logging into) a Level 68/DPS 
System, a user is allocated system resources in an 
enviromnent termed a "process." Specifically, the 
process is dynamically assigned space within the 
virtual memory (address space) and other system 
resources as required. As a result, each user views 
his process as if it were the only one in the system. 
In this environment, the user's address space dy- 
namically grows and shrinks as program require- 
ments expand and contract and the activity is 
iDlally transparent to the user and imder control 
ol the shared operating system. The system creates 
ii process al log-in time and destroys il at log-out 
time on behalf of each user. The user executes his 



program and system commands in coexistence with 
the processes of all other logged-in users under the 
multiprogramming control of the Multics operat- 
ing system. 

SYSTEM FEATURES 

Some of the more important features of the 
Level 68/DPS interactive programming envi- 
ronment include: 

• Flexibility of enviromnent shaping 

• Information sharing in the Level 68/DPS 
Virtual Memory and Storage System 

• Powerful language processors 
Extensive support facilities and tools 
Powerful command processor 
Protection (security) 
Special user interfaces 



Flexibility of Environment Shaping 

The administration of a typical Level 68/l)PS 
system includes one system administrator and 
multiple project administrators, l-ach project 
administrator dellnes the working environment 
for users in that project. He may give a user maxi- 
mum Hexibility by allowing him complete control 
m creating his own initial process, or he may limit 
the user's capabilities by restricting access to vari- 
ous software functions. 

The project administrator, then, defines the range 
of access each user has to system software func- 
tions. If the user has complete control of his own 
process environment, he may change parts of that 
environment and still be within the normal oper- 
ating conventions of the system. 

Information Sharing in the Level 68/DPS Virtual 
Memory and Storage System 

A Level 68/DPS system provides total sharing of 
data between users. In addition to sharing the oper- 
atmg system's modules, libraries, language proces- 
sors, and applications, users can even share user 
code and data. This is possible because all level 
68/DPS compilei-s generate pure, reentrant code by 
default. 
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All procedures and data arc contained within the 
Level 68/DPS Storage System and its associated 
virtual memory including lacilities that provide the 
user with extensive control over file manipulation 
and file sharing. A user can specify which individ- 
uals may access his files, and by which mode of 
access. Access can be given to one user, to a group 
of users (project), or to a particular class of users 
(interactive or batch). 

The Level 68/DPS Storage System is supported by 
a powerful virtual memory, totally transparent and 
available to the user as needed. Virtual memory dy- 
namically expands and contracts according to user 
.-^»,,(!««-'»'Y>«"tc 'inH cv/ctf»ni ri^cou^cc** Thiis^ Droaram- 
mers no longer need to be concerned about over- 
laying or partitioning program modules to satisfy 
limited main memory resources. Instead, they can 
concentrate on program synthesis and on develop- 
ing the most efficient algorithm to solve their 
particular problems. 

Powerful Language Processors 

Level 68/DPS includes several fully compatible lan- 
guage processors. Foremost is a functional PL/ 1 
compiler that is used for both system programmers 
and applications programmers. The present PL/I 
compiler has undergone several major design iter- 
ations to become perhaps the most stable and re- 
liable PL/I compiler in existence. This is the same 
PL/1 compiler that is used to produce the Multics 
operating system software itself, 95 percent of 
which is written in the PL/I language. 

Level 68/DPS supports COBOL-74. As with all 
Level 68/DPS compilers, COBOL programs can 
call programs written in any other language, 
thereby offering developers optimal flexibility. 

A complete FORTRAN compiler is available to 
satisfy any FORTRAN requirement as well as to 
facilitate the transfer of software from other com- 
puter systems. 

A BASIC compiler offers quick compilation and 
execution. It can be used as an independent lan- 
guage processor or in the simple time sharing sub- 
system called FAST. 

An APL language processor is also available. 
This is an interactive interpreter with exten- 
sive functionality. 

For users who find it necessary to write portions 
of their software in the language o\' the host com- 



puter, Level 68/DPS includes the ALM (Assembly 
Language for Multics) assembler. This assembler 
supports all system requirements for interprogram 
communication. 

A program written in any language available ow I 
Level 68/DPS can also call programs wriUen in 
another language by merely following (iiat lan- 
guage's calling conventions. For example. AIM, 
functions can call PL/ 1 procedures. 

All compilers will automatically generate pure, 
reentrant code for users, making all programs 
immediately shareable. 

Extensive Support Facilities and Tools 

Stable and reliable software components within 
the Multics operating system provide numerous 
utility and support functions. Foremost among 
these are the text editors. These text editors have 
undergone several design iterations to increase 
their reliability and sensitivity to human 
engineering requirements. Level 68/l)PS text 
editors range from a simple editor supporting 
line-numbered files to advanced editors for ex|>e- 
rienced users. 

Several extensive interactive debugging packages 
permit a user to analyze and correct a compiled 
program at both the original source level and the 
more specific machine-register level. 

Tools to measure performance permit the user to 
analyze a program's behavior and facilitate the 
development of optimum applications software. 

Inter-user communication facilities, both immedi- 
ate and deferred, permit online messages to be 
transmitted among users. In addition, online docu- 
mentation facilities provide the user with useful 
word processing and document preparation tools. 

Powerful Command Processor 

The command processor, by which a user commu- 
nicates his requirements to the' system, accepts 
input from a console, interprets the user's request, 
and invokes the software component to perform 
the desired function. The software component can 
be either system- or user-supplied; there is no dis- 
tinction at the command level. The command 
processor allows recursive, iterative commands 
and the embedding of function calls in the com- 
mand line. 

The command processor is a shared, replaceable 
module, written in PL/1. Therefore, if the project 
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administrator desires, a user can be required to 
interface with a special version of the command 
processor (possibly user-created), thereby limiting 
he software requests or commands available to 
iim. The command processor thus permits an ex- 
tremely wide range of interfaces to all system fa- 
cilities on either a controlled or open-ended basis. 
Tools are available to the user which allow the ab- 
nreviation of commands or character strings for the 
development of personalized shorthand methods 
lor directing program execution or accessing files. 
A facility also exists which allows users to program 
." co,n,nands with logical branching, variable main- 
tenance file management, and I/O control. This 
allows the development of complex applications 
without the involvement of language processors^ 
The command syntax has been designed to provide 
as sophisticated and flexible a user interface as any 
"ser might possibly require for both a commutative 
and associative syntax form. However, simple 
requests have a simple form. 

SUMMARY 

• The Level 68/DPS interactive programming envi- 
ronment provides facilities for both the novice and 
advanced user, for a wide range of applications. 

• The user's virtual memory (address space) 
dynamically changes as program and data 
requirements change. 



• A unique process environment exists for each 
user and this environment can be reshaped as 
needed. ' 

• Files are protected by user-specified access 
controls. 

• Level 08/DPS includes several lanm.age proces- 
sors: COBOL-74, PL/I, FORTRAN IHS! A-'- 
and ALM. " ' • 

• The support facilities of Level 68/l)|>S inch.dc 
text editors, program debugging aids. perfornKUKe 
measurement tools, inter-user communication 
racilities, and online documentation aids 

• The Level 68/DPS command processor allows a 
w de range of interfaces to all system facilities 
cither on a controlled or open-ended basis ' 

• included within Level 68/l)|>S are special user 
interlaces that permit the development ofolhe, 
operating systems, closed subsystems, or Imiited 
service facilities. 

SYSTEM CONFIGURATION 

The functions described herein are applicable to 
any Level 68/DPS configuration. 
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Controlled Sharing 
and Security 



III today's data processing environment computer 
security is a major concern. News stories tell of 
m.lhons of dolJars being stolen; company proprie- 
tary mformation being sold to competitors; and 
valuable information being deliberately destroyed 
or altered. In addition, there is growing concern 
regardmg the protection of individual rights - just 
what type of data can be compiled on an individual 
and how should such information be protected 
trom unauthorized disclosure. At this time, laws 
protecting privacy carry both civil and criminal 
penalties. So the processing of sensitive information 
on an msecure system exposes companies to loss 
and fraud and, potentially, to civil and criminal 
proceedings. Secure computer systems have become 
a vital concern to the data processing industry. 

SECURITY MECHANISMS 

Level 68/l)PS is the most secure computer system 
commercially available.' Level 68/DPS and its 
Multics operating system provide security by a 
combination of methods unique in the industry 
These methods are designed into, and are an inte- 
gral part of, the functioning of the system. Because 
the security mechanisms are implemented in both 
hardware and software and are applied universally 
to all user and system functions, they are far more 
difficult to subvert and security benefits are 
achieved with insignificant system overhead. 

Initial Access 

Initial access to the Level 68/DPS system is con- 
trolled by means of the user identification and 
password. 

The password mechanism is the first and most 
important line of security since it controls access 
to the system ami verifies the user's identity .mon 
which further access decisions are based. To ensure 
that u.sers treat passwords with the care the system 
requires, Multics provides facilities to allow usen? 
to change passwords easily, to peimit the System 
Security Administrator to compel periodic pass- 
word changes, and to require users to use system- 
generated, pronounceable passwords. 

When Hie system requests the entry of the pas.s- 
word al log-in lime, the phiK mechanism of the 



users terminal is turned off (if the terminul has 
this feature) or a mask is printed, over wliich the 
password is typed. Thus, a password is never dis- 
played in readable form when it is entered. 

Passwords are stored in encrypted form wilhin (he 
system When a user logs in, the typed password is 
similarly encrypted and the scrambled values are 
compared. 

Multics audits the usage of each password. || also 
counts incorrect passwords and ly,)es a message at 
log-in, telhng the user how many times (ha( pass- 
word has been given incorrectly since its las( cor- 
rect entry. This alerts the user to the possibility tini 
someone has attempted to guess the password." 
The System Security Administrator can also set an 
entry in the system message table causing a message 
to be sent whenever the user is logged in and some- 
one else attempts to log-in with the .same name 
project, and password. 

Once verified and accepted by the system, the user 
IS screened for information sharing (i.e.. the kind 
of access permitted to the file system and (o user 
and system software). 

Information Sharing Controls 

Beyond the password control (which screens every 
person attempting to use the system), ilnee addi-' 
tional controls regulate access riglKs to all ilala and 
programs in terms of individual users and processes 
Ihese inlormation controls are access control lists 
access isolation mechanism, and the ring proteetioii 
mechanism. 

ACCESS CONTROL LIST (ACL) 

The access rights for each seument are derin..^ in it. 
access control list (ACL). Through the A( I users' 
can, at their own discretion, grant or deny access t(, 
their segments and directories. The ACl specifies 
the users who have been granted access to the seg- 
ment and the mode of access allowed them Users 
who do not appear on the A( I, have no access lo 
Hie segment. Read, write, execute, and null' per- 
mi.s.sions may be speciljed lor segments (I)„ih data 
imd program); status, modify, and append accesses 
may be specified for file system directories These 
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permissions may be specified by user name, by 
project, or by "instance" (whether a process is ab- 
sentee or interactive), or by any combination 
thereof. Gasses of users can also be specified; for 
instance, all the users m a project, specific users in 
8 project, or even all users in all projects. Access \% 
initially verified by MuHic^i software and is enforced 
by the hardware every time the legmerit i% refer- 
enced thcrcaflcf, 

ACCESS ISOLATION MECHANISM 

The Access Isolation Mechanism (AIM) allows 
administrators of the system to define several 
levels of privilege, which the system itself en- 
forces rigidly. Enforcing the separation of these 
levels is totally independent of other access 
control or user action. This administrative mech- 
anism overrides user discretion in granting access 
and ensures privacy by preventing inadvertent or 
malicious disclosure of information between 
these privilege levels, even by those who "own" 
the information. 

AIM can be explained in simple terms. At log-in 
time, each process is assigned a sensitivity level 
and category (clearance) based upon the clearance 
of the user, the terminal, and the project. Also, 
every directory and segment (object) within tuc 
storage system has a sensitivity level and category 
(classification) associated with it. If the clearance 
of a process is equal to the classification of the 
desired object, all access to the object (allowed by 
other access control mechanisms) is permitted. If 
the clearance of the process is greater than the 
classification of the desired object, read, execute 
or status permissions are allowed to the object 
(within constraints imposed by the other access 
control mechanisms). Finally, if the clearance of 
a process is less than the classification of the de- 
sired object, all access to the object is denied. 

AIM supports 8 clearance and 18 "need-to-know" 
categories within each level. Access is granted or 
denied explicitly on the basis of the security classi- 
fication of a file or program and the security clear- 



ance of the user. This mechanism supplements the 
access control lists. Like the ACL mechanism. 
access is initially verified by Multics software and 
thereafter enforced by hardware at every reference. 
AIM can be invoked or disabled at the discretion of 
each Multics site. AIM also provides extensive secur- 
ity auditing controls to monitor user activity 

RING PROTECTION 

The Level 68/DPS Security System uses a hardwaa*- 
implemented, multilevel ring structure to control its 
users and to protect itself. The ring structure is a 
generalization of the two-state capability of other 
computer systems (master/slave mode, supervisor/ 
program state, etc.). With Multics, the structure uas 
been expanded to eight states or "rings of protec- 
tion" numbered (most privileged) through 7 
(least privileged). The operating system resides in 
the most privileged rings, through 2, while users 
generally operate in the less privileged rings, 3 
through 7. The segments of the operating system 
are in the most privileged rings to prevent uncon- 
trolled access or modification by the users of essen- 
tial system information. 

The basic rule is that users can only reference 
those segments in the same or less privileged 
levels than the ring in which ihey are ciuiciiiry 
executing. Access to higher privileged rings is 
only possible through a gate program. (This is 
analogous to master mode entry, supervisor call, 
etc.) The use of eight levels of protection rather 
than two allows user programs to take advantage 
of features for protection normally reserved for 
operating system software. 



' In a 1975 study conducted for the Air I'orcc, the MITRI- (.i)r|H)r;i- 
tion concluded that Multics is the most secure operatinp system 
available. 

* Null access is implied by defauil; that is. it" a user does luil issue a 
command granting another user access to a scjimcnt or directory, 
that other user cannot access the data in any way. Uowcvcr. null 
is useful in selecting a small number of individuals from a project 
to whom it is desirable to deny access. 

StK'cifications may change as design improvements arc introduced. 
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Multics PL/I is a language processor designed for 
commercial, scientific, and system programming 
applications. It was developed on Honeywell equip- 
ment in conjunction with the Massachusetts Insti- 
tute on'echnology. Multics PL/I is the language 
defined by the American National Standards Insti- 
tute's PL/I standardization committee and is sched- 
uled to become a standard. 

The compiled code is extremely efficient. The 
compiler was specitlcally designed for Multics and 
has been used to compile itself and most Multics 
software. 

ADVANTAGES 

Compilation and execution may be initiated 
through absentee (Multics batch processing) or 
interactive mode. 

Programs written in PL/I ensure permanent com- 
patibility and ease of maintenance. 

Object modules are produced such that no relocat- 
able edit is required. The normal mode of opera- 
tion is to execute with dynamic linking and loading 
so that unreferenced data and unused programs are 
never loaded into main memory. 

Relocatable object permits the binding of sepa- 
rately compiled programs together into one seg- 
ment which has fewer pages than its unbound com- 
ponents. 

A run-time symbol table may be created by the 
compiler and used by the Multics debugger to 
make symbolic references to the program data at 
run time. There is no special checkout compiler 
and therefore no recompilation necessary to debug 
a program. 

An optional OPtinii/t^r n»»rrnrt-nc ^^y f^»i-.o;.7^ ^»>+:^: 

zation of common expressions, conversions, and 
accessing code througliout a procedure or begin 
block. Register allocation is based on usiige statis- 
tics gathered by the optimizer resulting in intelli- 
gent use of pointer registers by the object code. 

CAPABILrriES 

PL/I is a block-structured language that allows 
both internal and external names. ITiis feature 



facilitates the development and maintenance of 
modular PL/I programs. All procedures are recur- 
sive and sharable. 

Multics PL/I has a comprehensive set ofdala for- 
mats. These include eight distinct types of data: 
arithmetic, .string, locator, format, label, entry, Irle, 
and area data. These formats give PL/I considerable 
descriptive power. 

In addition to fixed-point and floating-point binary 
arithmetic, Multics PL/I provides variable precision 
true fixed-point and floating-point decimal arith- 
metic of up to 59 decimal digits directly supported 
by hardware. Stnicture variables (similar to the 
hierarchical descriptions of COBOL) enable the 
programmer to explicitly define data structures as 
any aggregate of elementary data formats. 

Dynamic allocation for scalar variables and aggre- 
gates is provided by the automatic, controlled, and 
based storage classes. 

PL/I has powerful bit string and character string 
handling capabilities. Operations and functions are 
performed on either fixed or variable length 
strings. The extended instruction set of the central 
processor is fully utilized to perform character- and 
bit-string operations, picture editing, as well as 
decimal arithmetic and arithmetic base con- 
versions. 

Arithmetic, string, or pointer variables declared 
with the "unaligned" attribute are packed into the 
minimum number of bits, giving the programmer 
complete control over the packing of structures 
and arrays. 

Through the use of pointer-valued Multics func- 
tions and PL/I based variables, a user can easily 
access any bit in the entire virtual memory. 

Declaration of initialized arrays and data structures 
is permitted. Components can be freely interspersed 
in PL/I programs to aid in program documentation. 

Multics PL/I utilizes the full ASCII character set 
defined in American National Standards Institute 
standard X3.4-I%S. Both uppercase and lowercase 
letters can be used to form names up to 15h char 
acters long. This offers the usi-r greater nannng 
flexibility. 
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The % include macro provides for the inclusion of 
program text without the use of a preprocessor. 
Complete symbol listings show how each name was 
declared, as well as its attributes, and its address 
allocation. 

The compiler diagnoses over 350 errors, giving 
complete, readable diagnostics that include the 
erroneous statement or name. Warning diagnostics 
are given for common mistakes such as an 
undeclared name or implicit conversion of data 
types. 

PL/1 programs may call procedures written in other 
languages or vice versa provided they observe the 
interface conventions, as is the case with the other 
compilers in the system. 

Multics PL/1 and FORTRAN compilers have simi- 
lar options, program listings, and error messages, 
and in fact share the same compiler code genera- 
tion module phase and are, therefore, completely 
compatible. 

PL/I input/output facilities provide a convenient 
method of constructing and maintaining large files 
within the virtual memory or on removable media. 
The PL/I "do" statement and "if statement allow 
the programmer to construct flexible program logic 
without the proliferation of statement labels. 



Tlie "on" statement of PL/l permits the program- 
mer to make arrangements to handle special condi- 
tions which arise during execution. These condi- 
tions can arise as the result of errors recognized by 
the hardware or be signalled by the program itself. 
Multics virtual memory, coupled with PL/I pointer 
data, facilitates the programming of complex list 
processing techniques. 

OTHER MULTICS FEATURES 

Multics PL/I is a powerful language on a powerful 
system. One of the most advanced computer sys- 
tems in the world, Multics offers extensive security 
provisions, virtual memory, inieraciive prograiri- 
ming environment, hierarchical storage of data, and 
highly functional administrative control features. 
For more information on the Honeywell Multics 
System, contact your Honeywell Marketing repre- 
sentative. 

SYSTEM CONFIGURATION 

The functions herein described are applicable to 
any Level 68 Multics configuration. 



Specifications may chHnne as desintn improvements ure iiitrtnluced. 
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Multics APL is an advanced version of the APL 
programming language - an interactive system for 
use witli Honeywell's large-scale Level 68/DPS 
computers. Multics APL is a general purpose lan- 
guage that is both easy to learn and powerful to 
use. It is interactive by design - problems can be 
attacked swiftly, error messages are informative, 
errors can be corrected quickly and easily - all 
within the APL environment. 

APL brings the full scope of data processing to 
business and technical problem solvers who may 
have little programming experience. 

It is particularly well suited for business and scien- 
tific applications requiring the manipulation of 
arrays of data. Typical business applications include 
financial modeling, investment analysis, sales fore- 
casting, and payroll and budget analysis. Scientific 
applications include linear programming, regression 
analysis, and pipe stress networks. 

BENEFITS 

Multics APL offers substantial benefits: 

• Provides powerful language statements for 
easier problem solving 

• Provides a set of tools for interactive develop- 
ment, debugging, and execution of programs 

• Offers data processing capabilities for any level 
of programming expertise 

• Reduces time for programmer system develop- 
ment thereby increasing programmer productivity 

FEATURES 

llie following features make Multics APL partic- 
ularly attractive: 

• File access capabilities 

« Ability to store APL functions and programs 
for later execution 

• Ability to automatically start a function 
executing when program is loaded 

• Powerful execute operator which interprets a 
character string operand and may produce a 
character string result 

• Ability to diagnose errors in a longer, more 
explanatory format to assist new APL users 



• Support of ASCII terminals and a variety of 
APL terminals (especially graphics terminals) 

• Several preprogrammed workspaces, including 
a fully documented, tutorial course for user self- 
instruction in Multics APL 

• ASCII-compatible character set 

• Accurate floating point computations 

• Sizable arrays and unlimited workspace in 
virtual memory 

• File system that does not require knowledge 
of job control language 

• Full security and integrity protect programs 
and data from unauthorized use or modilKJition 

• Convenient interface to other Multics prt)- 
gramming languages 

• Software to convert from IBM to Multics 
format 

• Ability to access Multics data bases via 
PL/l subroutines 

SYSTEM DESCRIPTION 

System operation is straightforward. At a tcrnii- 
nal, the user simply calls Multics APL, and then 
types an expression to be evaluated. The Multics 
APL interpreter performs the calculations, prints 
the results, and awaits a new input line. The results 
of an expression evaluation can also be assigned to 
a variable and retained from line to line lor use in 
subsequent evaluations. 

In addition, a secjuence of calculations can be 
stored as a function to be recalled by name and inter- 
preted as a single entity. The result of the function 
is processed as though the entire sequence of expres- 
sions had just been entered at a terminal. Results 
from any form of expression evaluation may be 
printed at the terminal, presented in graphic form 
(on a suitable terminal), formatted into a tabular 
report, or stored in a file for subsequent retrieval 
and processing by Multics APL, or other program- 
ming languages. The entire state of any Multics APL 
session may be saved for subsetiueni use, incluiling 
all variable names, their current values, ami stored 
program functions. 

The APL language employs a special character set 
(normally requiring a special APL terminal) in 
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which most operations are represented by a single 
character. Besides the more common operations ' 
(add, multiply, etc.), Multics APL provides single- 
character operations for more complex functions, 
ajch as sorting, random number generation, and 
matrix inversion. Some of these functions are 
iuited particularly to the manipulation of large or 
complicated data arrays. 

Access to a special APL terminal is not required; 
Multics APL can be used from an ASCII terminal 
through a special set of over-strike conventions. 
Unlike similar conventions in any other APL, this 
convention preserves the visual appearance of APL 

nrngptnvi It k ac <»aew to rAqrl yft,ui^ adt ^^^ 

grams on an ASCII terminal as it is on an APL 
terminal. Multics APL supports all APL terminals ~ 
including EBCDIC, Correspondence, APL/ ASCII 
bit-paired, and APL/ ASCII typewriter-paired. 
The Multics APL character set is a compatible 
superset of ASCII; hence, character data can be 
easily and efficiently shared between APL and 
other Multics programming languages. 

By using powerful APL language elements, the 
user can devote full attention to solving the prob- 
lem at hand. Multics APL helps the user avoid the 
wviu^ivAiLib^a ui mc iituiviuuai pfogrammmg sieps 
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required and the interrelationships of the system 
operation. For example, inversion of a matrix, 
which would involve many program statements 
with nested loops and indexing in other pro- 
gramming languages, is accomplished with a 
single-character operation in Multics APL. 

Multics APL can call APL functions written in 
PL/I, which, in turn, can call programs written 
in BASIC, COBOL, or FORTRAN. The PL/1 
coded function can be niladic, monadic, or 
dyadic, and can optionally return a result. It can 
diagnose the same errors any APL operator can 
diagnose and can call out to any other Multics 
subroutine or system interface. 

thus, this facility enables the APL user to get at 
any system interface or application program by 
writing a short PL/I program to transform the call. 
This means the Multics APL user can easily inter- 
face to the Multics Graphics System, the Multics 
Relational Data Base Manager, and other |>ackages. 

SYSTEM REQUIREMENTS 

Multics APL runs under the control of the Multics 
Operating System on all models of Level 68/l)PS. 

.Spccificalions niay change as design imprciveincnis are inlrttdincil. 
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Honeywell's Multics Data Base Manager (MDBM^ 
provides Level 68/DPS users with a powerful ' 
versatile, efficient, and easy-to-use data base man- 
agement capability. MDBM functions as a subsystem 
of the Multics operating software, and makes use of 
the Level 68/DPS virtual memory and file manage- 
ment subsystems. It is designed to support concur- 
rent access to up to 64 data bases of up to 1 80 
billion characters each. 

Much of the versatiHty of MDBM derives from the 
tact that it offers the user a choice of two different 
methods for structuring and manipulating a given 
data base: a relational approach and a procedural, 
CODASYL-standard (Conference on Data System' 
Languages) approach. While all data is stored in a 
relational format, two differing interfaces are 
visible to the user. 

The relational technique greatly simphfies the job 
of programmers and end-users, as a detailed knowl- 
edge of the logical structure of the data base is not 
required to use it. MDBM performs the retrieval 
function automatically. For example, a person 
seeking data writes a statement that defines the 
nature of the data required; he does not provide 
specilic instructions as to where and how the data 
is to be retrieved. 

At the same time, the procedural approach is 
available to those programmers who are familiar 
with and prefer CODASYL data base techniques. 
MDBM is the industry's first fully implemented 
relational data base manager commercially available 
Irom a computer manufacturer. It is also the only 
data base manager to offer both relational and 
CODASYL capabilities in the same system. 

MDBM BENEFITS 

The Multics Data Base Manager provides the follow- 
ing benefits: 

• Impm vcd pro.munnn'r pmdmtmiy Program- 
mers ciui accomplish data base tasks with much 
less effort when employing MDBM's relational 
capabilities. 

• New cnd-usvr flcxibiliiy Because of the sim- 
plicity of relational techniques, end-users can inde- 



pendently retrieve data base information without 
support from the programming staff. 

•Ease of maintenance ~ The tasks of entering and 
changing data are greatly simphfied. 

• Data storage efficiency One data base system 
can meet the needs of an entire organization without 
redundant files and effort. 

• Improved data accuracy The elimination of 
redundancy ensures consistent information with 
fewer chances of error. 

• Ensures data integrity and security - Inherent 
Level 68/DPS integrity/security features are avail- 
able to the MDBM user. 

MDBM FEATURES 

The Multics Data Base Manager includes the follow- 
mg significant system design features: 

Relational interface - Multics Relational Data Store 
(MRDS), a component of the data base manager, 
represents data relationships by means of fofmai 
algebraic entities. A user structures and accesses 
data hies without concern for how or where the 
data is actually stored. As a result, the user's (ask 
is greatly simplified. 

Procedural interface - Multics Integrated Data 
Store (MIDS) provides an interface with the data 
base manager following CODASYL standards 
MIDS is a subset of Honeywell's I-D-S/II data base 
management system. This capability is highly llcx- 
ible, allowing the building of network, hierarchical, 
sequential, or cyclical structures. 
Language independence - Any Level 68/DPS 
supported language may be used to access MDBM 
facilities, including COBOL-74, PL/I, FORTRAN, 
APL, BASIC, and Assembler. Well-defined CALL 
statements are employed. 

Independence of processing modes MDBM sup- 
ports all processing modes such as transaction proc- 
essing, time sharing, batch, remote job entry and 
direct access. All of these modes can be supporled 
simultaneously. 

Controlled sharing All user data (as well as oper- 
ating system software, libraries, and u.ser code) is 
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potentially snareaDie at ttie discretion of its owner. 
Since all Level 68/DPS language processors generate 
only pure reentrant code, no copies or reloads are 
required. 

Data definition and program independence - Data 
definition is an independent function. In most cases, 
changes to the data base will not require repro- 
gramming of user applications. 
Query capability - A special MDBM query language, 
termed LINUS (Logical INquiry and Update System), 
provides comprehensive query capabilities. 
Online access and update - Records may be easily 
added, modified, or deleted online. Multiple users 
may access the same data base concurrently. MDBM 
can be invoked by as many users as are allowed on 
the system. 

Concurrent access and update controls ~ Update 
privileges can be assigned to individual users or 
classes of users. To ensure integrity, users may 
specify exclusive use of the data base when it is 
opened; or, if sharing a data base, users may tem- 
porarily reserve a record type and associated sets 
during critical update operations. It is possible for 
privileged users to specify exclusive update, which 
locks out all other processes attempting to access 
tuC uuta uase; and it is also possible to specify ex- 
clusive retrieval, which locks out all updaters from 
the data base. 

Report generation - The Level 68/DPS Report 
Generation Language (RGL) facilitates the produc- 
tion of reports, in conjunction with either the 
LINUS query language or ASCII files. 
Automatic data recovery and restart - MDBM uses 
Level 68/DPS backup/retrieval mechanisms. They 
provide recovery of a data base after system failure 
or when a disk has been damaged. 
Monitoring ~ Tools exist to monitor data base usage 
from various aspects. 

Dynamic tuning - A system administrator can view 
current monitoring data from a terminal and dynam- 
ically alter parameters to affect performance. 
Data integrity and security - Level 68/DPS is the 
only system where all data integrity/security fea- 
tures are implemented in both software and hard- 
ware. MDBM derives its superior integrity/security 
characteristics not from provisions within the data 
base manager, but rather from design features of 
the Muitics operating system and Level 68/DPS 
hardware. 

TERMS DEFINED 

The relational and (^Ol)ASYL approaciies have 
developed separately, so that terms used in de- 
scribing one approach differ substantially from 
those used for the other. Table 1 is provided to 
bridge this terminology gap. 



TABLE! -TERMS 



Traditional 
Data Processing 
Terminology 



Record type, class or 
format (physical) 



Record type, class or 
format (logical) 



Record occurrence 



Field/element 



Range of values (the 
set of all values associ- 
ated with a field type) 



Total data base defi- 
nition 



Program view of data 
base 



Honeywell MDBM 



Relational 
Approach 



physical record 



relation 



tuple 



attribute 



domain 



data model 



data submodel 



CODASYL 
Approach 



physical record 



record type 



record occurrence 



data cicmenl/ricid 



largely ignored 



schema 



subschema 



DATA BASE DEFINITION PROCESS 

Figure 1 illustrates the MDBM data base definition 
process. Users may create and access a data base 
using either the MRDS or MIDS interfaces with the 
following restrictions: 

• A data base created using the MIDS facility may 
be accessed only with MIDS programs. 

• A data base created using the MRDS facility may 
be accessed only with MRDS programs. 

The definition of a data base in MDBM is accom- 
plished by the user or data base administrator de- 
fining either: 

• A data model for a relational data base. 

• A schema for a CODASYL data base. 

The data descriptions are not directly referenced 
by user application programs, and each application 
program may have a different view of the data base. 
The definition of that portion of the total data base 
affecting a particular program is accomplished by 
defining either: 

• A data submodel. 

• A subschema. 

Partial views (data submodels or subschemas) nuist 
be proper subsets of the total data base delinilion. 

In the case of a relational (MRDS) data base, (lie 
data model definition file contains the complete 
description of the different data elements to he 
found in the data base. This is the data base admin- 
istrator's view of the data base. The data submodel 
definition file contains the definitions of those re- 
latit)ns and attributes of interest to a specific pro- 
gram. This is the user's or programmer's view of I he 
data base. The data submodel is defined indepeiui- 
ently of the data model and no binding is done 
until application program execution open-time. 
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Data types for data submodel attributes are not 
defined within the data submodel; they are defined 
within the application program. They may differ 
from the data types defined in the data model for 
the corresponding attribute name. Allowable data 
types (in PL/I terms) are real and complex fixed 
binary, real and complex floating binary, real and 
complex decimal, varying and nonvarying bit string, 
and varying and nonvarying character strings. 
Binary data types may be single or double precision. 
When a data base administrator defines an MIDS 
data base, both a schema and a data model defini- 
tion file are automatically created (Figure 1). The 
schema definition file contains only information 
associated with a CODAS YL data base relevant to 
the data structure/organization of that di^ta base. 
Schema entries contain data and network structure 
information while data model entries contain de- 
scriptions of the data elements in the data base. 

Again, data descriptions in the schema definition 
file are not directly referenced by user application 
programs. The user or data base administrator de- 
fines that portion of a total data base of interest 
to a particular program by use of a subschema. A 
subschema definition contains only the application 
program view of the data base and is the MIDS 
counterpart of the data submodel in MRDS Gust 
as the schema is the MIDS counterpart of the data 
model). 

In practice, MIDS controls structural definitions, 
whereas MRDS controls data definitions. 
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Figure 1. MDBM Data Base Definition 



THE RELATIONAL DATA STORE 

The Multics Relational Data Store (MRDS) pro- 
vides an integrated set of functions to support the 
description and processing of a wide variety of data 
base structures. Data independence is achieved 
through the use of data model/submodel concepts. 
The MRDS user defines a data model using a tech- 
nique known as "normalization" or "reduction 
to third normal form." The process of normalizing 
a data base consists of a subjective process per- 
formed by the data base administrator whereby 
complex relations are reduced or transformed into 
simpler relafions without loss of information or 
dependencies. The rationale for using the third 
normal form relational model derives from certain 
anomalies which can otherwise occur in a relational 
data base. 

The data model or data base definition is defined, 
accessed, and maintained by the data base admin- 
istrator. The administrator, working in conjunction 
with application users, defines a valid data sub- 
model to be referenced by each application pro- 
gram. Under certain user-controlled circumstances, 
a user may act as his/her own administrator and 
deal directly with the data model. The data sub- 
model provides each application program with its 
view of a data base and must be a proper subset of 
the data model. 

The definition of a data submodel may differ from 
the data model in several ways: 

• Attribute names may differ. 

• Attributes may be omitted from a data model 
relation. 

• Attributes may be ordered differently within a 
relation. 

• Relations may be omitted. 

A data submodel definition may be created sepa- 
rately or in conjunction with an application program. 
Several data submodels may be associated with the 
same data model. Several data submodels may he 
referenced by the same application program. Data 

"w.i^aiiVJu».-a uwiiiiiinjiib may iijicist;ci. 

When defining a relation in a data model or sub- 
model, it is necessary to specify which adrihules or 
fields are to be used as components oldie primary 
key (i.e., key attributes). |{ach luple or record 
occurrence must be identifiable by some non-null 
primary key value which nuist be unicpie. The ex- 
pression for defining a relation and ilsaltrihules 
resembles the format used in most relational 
literature. 

The "open" procedure is called when the MRDS user 
wishes to access the data base. At this lime the data 
model and submodel are resolved, l-igure 2 illus- 
trates access activity. 
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Figure!. MDBM Data Base Access 



The MRDS Language Processor provides the user 
with the following capabilities: 

• Open and dose a data base defined by a specified 
data submodel. 

• Retrieve data based on a flexible selection capa- 
bility. 

• Modify and delete items within a data base. 

• Enter new information into the data base. 

• Perform the above while allowing for the maxi- 
mum possible concurrent access capability. 

The data manipulation capability provided is rela- 
tionally complete. That is, it possesses the full 
power of the relational calculus. Any query expres- 
sible in first-order predicate calculus is expressible 
in an MRDS selection mechanism. 

THE MULTICS INTEGRATED DATA STORE 

The Multics Integrated Data Store (MIDS) provides 
a CODASYL language interface to the functions re- 
quired to support the description and access to 
CODASYL data base organizations, including hier- 
arcliios and networks. Data indopondoncc between 
the physical data base and application programs is 
achieved tlirough use of schema and subschema con- 
cepts as specified by CODASYL. 
The sclienia describes the total data base and is 
defined and maintained by the data base adminis- 
trator. The administrator, working with prospective 
users, det'incs valid subschemas to be referenced by 
individuiil application programs. 



The subschema must be a proper subset of the 
schema. The subschema contains only the infor- 
mation necessary to define the data required by the 
application program. 

MIDS relies primarily on access control lists rattier 
than privacy locks or passwords to provide security 
at the level of the record and set. Concurrent update 
protection is provided at the record type and set 
name level. 

The following specific CODASYL schema defini- 
tion functions are supported by MIDS: 

• A data base, records, fields, and sets may be given 
names. 

• Record location mode may be specified as CALC 
or VIA SET. (All records in MIDS must be given a 
unique control key field even if the location mode 
is VIA SET.) 

. Field types may be BINARY, DECIMAL 

SIGNED, or CHARACTER. 

• Sets may be defined. 

• ORDER of set insertion is defined as PERM A- 
NI:NT INSERTION and DUPLICATES NOT 
ALLOWED for SORTl D ORDl-R. 

• Set members may be ordered ;>s I'lRSl', NlX T. 
LAST, PRIOR, or SORTED BY DlU-lNl D Kl YS. 

• Set membership is defined as MANDA rOR>' atui 
AUTOMATIC. 

• Set selection may be THRU OWNER IDEN fl- 
FIED BY CALC-KEY or BY APPLICATION. 



B-34 



A subschema may describe only that portion of the 
entire data base (i.e., schema) which is of particular 
interest to the application program. (A schema may 
be shared by a number of subschemas.) A subschema 
may differ from the schema in the following ways: 

• Field names may be renamed or omitted from a 
subschema record. 

• Field names may be ordered differently within 
records. 

• Field types may differ from the corresponding 
schema field type (although field types are not de- 
fined in the subschema, per se). 

• Records may be renamed or omitted. 

• Sets may be renamed or omitted. 

Several subschemas may be referenced by an appli- 
cation program and subschema definitions may 
intersect. Subschema record, field, and set names 
must be associated explicitly with schema record, 
field, and set names. Field types are defined in the 
using application program. 



At execution time the validity of the subschema is 
verified and the views of the data base represented 
by the schema and subschema are resolved. 

The following basic functionality is provided by 
MIDS Data Manipulation Language (DML): 

• READY 

• STORE 

• ERASE 

• FIND 

• GET 

• MODIFY 

• FINISH 

• KEEPX 

• FREEX 

It is possible to READY multiple subschemas within 
one process. 



Specifications may change as design improvements are introduced. 
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LINUS (Logical Inquiry and Update System) is a 
powerful and easy-to-use facility for accessing 
data bases from a remote terminal. It provides 
complete data base management capabilities, 
including both retrieval and update operations. 
LINUS functions as a subsystem of the Multics 
operating software and uses Multics Relational 
Data Store (MRDS) for data base access. LINUS 
is used by a variety of business professionals, 
including inventory control personnel, budget 
planners, geologists, and school administrators. 
LINUS uses a high level, nonprocedural data 
selection language called LILA (Linus LAnguage). 
LI LA allows people, who are not trained program- 
mers, to solve problems by working with data bases. 
The user views the data base as a simple set of 
tables, consisting of rows and columns; LILA 
provides an easy way to "look up" information 
contained in those tables. 

System operation is straightforward. At a terminal, 
the user simply calls LINUS and types a request 
for LINUS to open the desired data base. If the 
user is unsure of how to proceed, he types "help" 
for assistance. After the data base is opened, the 
user may call LILA and type a selection expression 
specifying the data to be accessed. LILA then proc- 
esses the selection expression, retaining it in a form 
suitable for reference by subsequent LINUS 
requests. 

After selecting the data, the user may type a LINUS 
request to manipulate it. Among the actions which 
can be performed are display the data on a terminal, 
write a formatted report, place the data into a 
Multics file for later use, and update the data base. 
The data may be acted upon by several manipulation 
requests, and new data may be specified at any time 
i^y typing a new LILA selection expression. 

BENEFITS 

LINUS is easy U) use. With three short words even 
an inexperienced computer user can get information 
from a data base using LINUS. These words are 
"select," "from" and "where." l-or example, a 
telephone directory can be thought of as being a 
table with three columns of information: name, 



address, and phone number. To find the phone 
number of John Smith, the user scans the name 
column for "Smith John" and reads the value from 
the phone number column in the same row. With 
LINUS, using LILA, this operation is described as: 

select number 

from phone book 

where name = "Smith John" 

Studies and experience have shown that inex- 
perienced users can attain substantial competence 
in LINUS within a matter of hours. 

Other benefits include: 

• Direct End-User Access - Using LINUS, the 
user can independently retrieve and update data 
base information without support from the 
programming staff. 

• Support of Unforeseen Requirenwnts Ihe 
LINUS user can immediately respond to unexpected 
information requirements by interactively selecting 
the desired data via a terminal, without writing a 
program. 

• Complete Selection Capability LINUS is 
powerful and "complete" in the sense that the user 
can select any information contained within the 
data base using LILA, subject to security constraints. 

FEATURES 

• Complete Data Base Functionality LINUS 
provides facilities enabling the user to add and 
delete rows from a data base table, to modify 
column values in a table, to define temporary tables 
for personal use, and to retrieve information from 
one or more specified tables. 

• Macro Facility A parameterized macro facility 
allows the user to invoke previously saved sequences 
of LINUS requests. This allows the tailoring of an 
environment to an Individual user. 

• LILA Line Editor A BASIC-like line editor 
built into LILA simplifies construction of data 
selection expressions. 

• Built-in and Uscr-dvfined I'unclions Huill m 
functions allow the user to delerniine sums, averages, 
and counts, of data as well as to search on such 
items as partial character string values, and roundeil 
or truncated numeric values. In addition, there is 
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a welJ detined method for dynamically adding 
functions required by local users. 

• Internal Variables - The LINUS user can assign 
retrieved data values to internal variables, allowing 
subsequent data selections to be dependent upon 
previously retrieved data. 

• Help Facility ~ A help request available within 
LINUS provides information on how to use its many 
facilities. The user need only type "linus" to invoke 
the subsystem, and "help" in order to begin using 
LINUS. 

• Table of Contents - The contents (tables and 
columns) of the data base may be displayed 
allowing a person unfamiliar with the structure and 
content of the data base to use LINUS. 

• Report Writing Capability -- Formatted reports 
from retrieved data can be created using either 
the Multics Report Program Generator (MRPG) 
or the WORDPRO facility, Lister. Either facility 
can be invoked with a simple LINUS request. 

• Multics - Any Multics capability can be invoked 



from within the LINUS subsystem. Some possible 
uses of this feature are sorting retrieved data viii 
the Multics sort facility, or editing retrieved data 
with one of the Multics text editors. 

• Data Base Creation The user can create a 
private data base via easy-to-use MRDS conmuinds. 
Special documentation oriented to the LINUS user 
makes this process especially simple. The data base 
can then be maintained and accessed using LINUS. 

• Data Sharing, Integrity, and Security - LINUS 
fully utilises MRDS and Multics facilities for con- 
current usage control, data base security, and data 
base backup and recovery. 

SYSTEM REQUIREMENTS 

LINUS operates under Multics on any Series 60, 
Level 68/DPS configuration. The availability ol 
MRDS is a prerequisite for LINUS operation. 



Specifications may cliannc as design improvements are inlroilnteti. 
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Word Processing System 

(WORDPRO) 



WORDPRO, another dimension of Honeywell's 
powerful Level 68/Distributed Processing System — 
Multics - provides a comprehensive set of software 
tools for developing a wide range of documents 
online. And because WORDPRO is integrated 
within the Multics operating software, its users can 
develop and maintain documents ranging from sim- 
ple form letters to complex technical presentations 
simultaneously with other data processing activities. 
The end result can be rapid turnaround time, im- 
proved productivity, and optimal quality in docu- 
ment preparation. 

WORDPRO BENEFITS 

Since WORDPRO is an integral part of Level 68/ 
DPS, it offers advantages unavailable with other less 
comprehensive word processing systems: 

• Ease of Use - People with little or no knowledge 
of Level 68/DPS or word processing can easily use 
WORDPRO for numerous text processing tasks 
Merely by following WORDPRO-generated instruc- 
tions, even inexperienced users can readily perform 
functions such as text entry and simple editing. 

• Security - The security provided by WORDPRO 
is the same security provided for all information 
stored in the Multics virtual memory. Because 
WORDPRO-prepared documents reside in the vir- 
tual memory, they receive the same high degree of 
security afforded any other job, file, or program. 

• Document Management Tools - WORDPRO docu- 
ment management tools make it easy to maintain 
documents onUne or offline in a standard format. 
These tools can be used for document file manipu- 
lation, archiving, document linkage, etc. The same 
tools which control 68/DPS storage also control 
WORDPRO documentation. 

• Tailored Environments - Level 68/DPS lets the 
WORDPRO user define exactly how text process- 
ing is to occur. UnUke other systems, WORDPRO 
users specify the types of terminals to be used 
iuui the various document formats to bo accepted. 
Interlaces to these devices can be changed at any 
time. 

• Selectable Administration 'Hie WORDPRO 
user is not bound by a restrictive administrative 
approach. Each site can define what the individuals 



using the system (terminal operators and document 
administrators) need to know. The roles of these 
individuals can be large or small depending on how 
a user's document processing activities are estab- 
lished. 

• Maximum Equipment Utilization - WORDPRO 
can help users make maximum use of slack com- 
puter time. Rather than have the system sit idle 
when not processing data, WORDPRO can use 
this extra time efficiently for text processing 
thus maximizing equipment utilization. 

• Total Integration with Data Processing Within 
Level 68/DPS, word processing and data processing 
are fully integrated. Data and text files created and 
maintained by WORDPRO can be accessed and 
used by data processing applications. Conversely, 
files created and maintained by data processing 
applications are available to WORDPRO users, all 
without special programming or conversions. 

DEVICE FLEXIBILITY 

Any terminal accepted by Level 68/DPS can be 
used for word processing. Users need not purchase 
special equipment or dedicate terminals for 
WORDPRO applications. If one set of terminals 
is used for input and update, other devices can be 
used for output. Text entered Trom one terminal 
can be modified by another without regard to 
terminal characteristics. 

TEXT ENTRY TOOLS 

Several tools are provided with WORDPRO for 
the entry of new text. With these tools, an indi- 
vidual with little or no prior word processing 
experience can easily power type raw text into 
the system for later update or incorporation into 
a document. 

The DOCUMENT routine is a simplified interface 
to all the WORDPRO tools. It lets the user pre- 
define document formats, and automatically 
generates the final document with paragraph ami 
page numbers, footnotes, table of contents 
(optional), etc. Paragraph editing is provided to 
allow paragraph addition, modification, and de- 
letion with automatic renumbering. Whole para- 
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graphs may be inserted from a prepared list of 
paragraphs. Speed typing, hyphenation, and all of 
the quality control and document management 
tools are also provided within the DOCUMENT 
interface. Once processed through DOCUMENT, 
the text can be printed at a terminal or high- 
speed printer. 

SPEEDTYPE - similar to typing shorthand - 
allows users to specify abbreviations for input of 
character sequences. When a document is printed, 
these abbreviations are automatically expanded 
to their predefined strings. The result is fewer 
key strokes typed, higher document quality, and 

TEXT EDITING 

Input text can be modified using either of the 
WORDPRO editors: cursor or string. Using a CRT 
device and the cursor editor, terminal users can 
simply type over portions of a document which 
are to be changed. 

String editing, which is more comprehensive than 
cursor, enables the user to manipulate strings of 
characters in a text for editing or updating pur- 
noses. String editing functions range from simple, 
line-oriented editing to context-oriented searching 
and replacement. 

Together, the WORDPRO cursor and string editors 
give the user the freedom to select the desired 
mix of simplicity and comprehensiveness. 

DOCUMENT FORMATTING AND HYPHENATION 

Tlie WORDPRO formatter provides document for- 
mat control. In addition to margin and page length 
control, the formatter handles automatic page and 
paragraph numbering, widow processing, table of 
contents and index generation, font and forms 
control, artwork placements, and automatic hy- 
phenation. Further, the formatter can control: 

• Headers/ Footers - Up to 20 headers and footers 
can be specified. These can be page numbers, copy- 
rights, logos, or the current date. These need only 
be specified once; they will be inserted automat- 
ically thereafter. 

• Footnotes - They are automatically generated, 
numbered, inserted, and maintained with the 
proper page. If footnotes are added or deleted, 
the remaining ones are automatically renumbered. 

• Pagination Pages can be automatically num- 
bered in Arabic or Roman numerals, in upper- or 
lowercase, or alpiuibetically. 



QUALITY CONTROL 

WORDPRO incorporates an extensive set of qual- 
ity control tools for detecting and removing typo- 
graphical errors from documents. First, SPFFD- 
TYPE can be used to correct typos at entry time. 
For example, common typing errors such as "hte" 
instead of "the" can be corrected by predefining 
the former string as an abbreviation to be ex- 
panded to the latter. Or, long difficult-to-spell 
words can be abbreviated, thus eliminating fre- 
quent misspellings. 

Online dictionaries can also be used to detect 
misspelled words within a document. WORDPRO 
offers a dictionary containing over 50,000 cor- 
rectly spelled English words. The content of a doc- 
ument is compared with the dictionary's entries, 
and any words not found are entered in an error 
file or printed at the user's terminal. Multiple 
dictionaries can also be developed. For example, 
a dictionary of technical jargon or frequently used 
non-English words could be established so that 
these types of words would not be considered 
misspelled. Dictionaries can be shared, if desired, 
or used as private versions. Dictionaries can also be 
added to or deleted from as desired. 

Change bars can be generated on documents under- 
going review. A complete list of changes (line-by- 
line) can also be generated in a separate file of 
notes. Additionally, text comparison programs 
allow review of new documents against older 
versions. 

LIST PROCESSING 

The generation of personalized form letters and 
billing statements can be accomplished using 
WORDPRO'S list processing capabilities. Lists of 
mailing addresses can be used concurrently by 
multiple terminal operators to create these types 
of documents with key pieces of information in- 
serted at various points. These list processing tools 
can also be used in conjunction with other 68/ DPS 
facilities (such as the data base manager) to supply 
current up-to-date account information for monthly 
statements, billings, etc. Mailing labels or pre- 
addressed envelopes can also be generated. 

ARTWORK 

WORDPRO can be used to generate diagrams, 
organization and How charts, and logos. Ihese 
figures can be included as part of Hie fiiKil, prinlod 
copy of a document. 
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OUTPUT CONTROL 

Numerous devices can be used to print review cop- 
ies or final documents. A terminal operator may 
request that a segment of text be output on a 
local or remote printer, thereby freeing the input 
termmal for other work. Line printers, plotting 
terminals, and CRT devices can all be used for 
output. 

High-speed offline printers, such as the Honey- 
well Page Printing System, can be used in con- 
junction with WORDPRO to generate multiple 
copies in multiple colors with preprinted forms 
Special forms control capabilities for line printers 
and plotting terminals permit documents to be 
printed on multipart, tear-away, or peel-off forms. 

Computer output microfilm/microfiche interfaces 
are available for generating, distributing, or archiv- 
ing documents on micro media. Documents can 
also be stored in files onhne, or maintained off- 
hne on tape, cards, etc. 

PHOTOCOMPOSITION 

Tlie WORDPRO design incorporates a photocom- 
position interface to allow the generation of con- 
trol information for automatic typesetting devices 
Ihis photocomposition facility is table-driven so 
that a variety of devices can be easily supported 
by simply modifying control tables. 

ELECTRONIC MAIL 

WORDPRO provides its users with a compre- 
hensive, secure electronic mail facility. This 



facihty allows message-switching networks to be 
established. Users can send and receive mail rang- 
ing from short, immediate messages to lengthy 
memos or documents, over these networks Secur 
ity is provided via a personal or shared mailbox 
area which is subject to extensive access control 
checking. Electronic mail can be the basis for the 
automation of a business's entire in-house mail 
operation, eliminating the need for couriers. 

ACCESSIBILITY OF OTHER FACILITIES 

Because WORDPRO is an integrated part of 
Level 68/DPS, its users can access other facil- 
ities. For example, financial data stored in a 
68/DPS data base can be selectively inserted into 
a WORDPRO-generated document to produce an 
up-to-date monthly or quarterly statement. The 
68/DPS Interactive Graphics package can be used 
to generate artwork for WORDPRO documents, 
and the Multics file management and manipula- 
tion tools can be used with online WORDPRO 
files. 

ADMINISTRATIVE TOOLS 

Implemented on a project-oriented basis, 
WORDPRO can easily control the use of proc- 
essing resources, access to documents and tools 
bilhng tor usage, etc. Users can be restricted to 
certain functions, or allowed access to full capa- 
bihties of WORDPRO. All the administrative 

r^u/^n^n?.''''^^'* ^^ ^^^"^ ^^/"^PS are applicable 
to WORDPRO administration. 

Specifications may change as design improvements are introduced. 
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The Multics Graphics System provides a general 
purpose interface through which user or applica- 
tion programs can create, edit, store, display, and 
animate graphic material. 

FEATURES 

• High degree of terminal independence 

• Ability to define graphic objects that may be 
used repeatedly in higher-level objects 

• Powerful editing facilities for graphic objects 

• Ability to store graphic objects permanently 

TERMINAL INDEPENDENCE 

The Multics Graphics System is organized into two 
distinct parts: the terminal-independent portion 
and the terminal interfaces. 

User and applications programs communicate 
exclusively with the terminal-independent portion 
of the system. This ensures that: 

• User programs and applications routines are not 
restricted to one particular terminal type, but can 
use whatever graphic terminal is available. 

• Users are not isolated from each other because 
of the types of terminals they use, but may freely 
use each others' programs on their own terminals. 

• (iraphic applications may easily be transferred as 
new and improved terminals become available. 
The Multics Graphics System can accept new types 
of graphic terminals with a minimum of coding. In 
most cases, the user need only specify the special 
characteristics of his terminal in a table and con- 
struct a program to perform any code conversion 
necessary. No special i/0 programming is required. 
He may then use any existing program or graphic 
file and obtain comparable results on his own 
device. 

STRUCTURED GRAPHIC OBJECTS 

Rather than treat graphic data as an unstructured 
collection of graphic elements (much as a sketch 
could be considered an unstructured collection of 
lines and points), the Multics Graphics System 
deals with structured descriptions of objects. 




Sample Grafihic Displays 
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1 his organization has three advantages: 

• Natural representation of most objects can be 
made in terms of their own inherent organization. 
For example, a piston, a complex object in its own 
right, may be treated as an elemental object within 
a graphic description of an engine. 

• Subpictures can be shared, thereby eliminating 
redundancy. 

• Powerful global picture editing capabilities are 
possible. 

PERMANENT GRAPHIC STORAGE 

Facilities are provided so that the user can attach a 
name to any graphic object and store it in a Multics 
segment. Such objects may be used at any time by 
any user authorized to access the segment. 

TERMINAL-INDEPENDENT GRAPHIC 
TRANSMISSION 

Graphic information is transmitted in a well- 
defined terminal-independent code. This code may 
be interpreted by a Multics program and converted 
to the appropriate codes to drive a graphic 
terminal; or it may be transmitted directly to an 
intelligent graphic device that performs its own 
interpretation, with a corresponding increase in 
efficiency. It may also be directed to a Multics file 
and "played back" on any graphic device to form 
background scenes or standard "canned" pictures. 



Graphic input sent to a Multics system is converted 
from its original format into this code before being 
forwarded to the terminal-independent portion of 
the system. 

SYSTEM COMPATIBILITY 

Programs originally written on other computers 
that make use of the most widely used set of 
graphic subroutines may, with minimal conversion, 
interface in the same way with the Multics 
Graphics with System. Interfaces to mimic other 
popular graphics systems are easily constructed. 

DYNAMIC AND INTERACTIVE GRAPHICS 

When used with a terminal of sufficient intel- 
ligence, the Multics Graphics System can perform 
real-time graphic operations, such as dynamic 
animation, incremental picture update, local pic- 
ture editing under control of the terminal, and 
sophisticated graphic input. 

SYSTEM REQUIREMENTS 

The Multics Graphics System is applicable to any 
Level 68 Multics configuration. 



Specifications may change as design improvements are introduced. 
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Multics Elearonic 
Mail Facility 



llie Level 68/DPS (Multics) electronic mail facility 
offers its users direct, online, person-to-person 
liislribution of text. It handles mail ranging from 
brief memos to nuiltivolume documents and deliv- 
ers that mail immediately to data terminals or on- 
line mailboxes. It is one of the many productive 
personal computing features of the Level 68/DPS. 

Honeywell's electronic mail facility operates in 
conjunction with WORDPRO, the Level 68/DPS 
word processing system, and automates the crea- 
tion, distribution, and updating of text information. 
Hlectronic mail can significantly reduce the volume 
of paperwork generated in a typical large organiza- 
tion, dramatically reduce the cost of disseminating 
documents, and avoid the delays normally associ- 
ated with physically generating and transporting 
documents. 

Tlie Level 68/DPS electronic mail facility offers 
definite advantages: 

• Each user can create a private "mailbox" - 
a special storage segment for mail delivery, or 
mailboxes may be shared for group use. 

• Any terminal recognized by the Level 68/DPS 
can send or receive electronic mail - no special 
devices are required. 

• A user can access his mailbox from any Level 68/ 
DPS recognized terminal at any location. 

Electronic mail provides such distinctive functions 
as: 

• Immediate or deferred delivery of messages, text, 
and other mail 

• Broadcast delivery to groups of users 

• Selective delivery only to persons with a "need 

lO ivHOW 

• A secure mailbox facility, protected by the full 
range of stringent security controls in Multics sys- 
tem software and liardware, to guard mail from 
unauthorized access 

• Simple commands to prescribe the mailbox 
access and mail functions allowed for specified 
users 

• Many document management tools for text 
manipulation and storage 



VARIETY OF USES 

Tlie Level 68/DPS electronic mail facility has a 
myriad of business uses. For instance, a large 
organization typically functions from a number 
of widely separated locations corporate head- 
quarters, research and engineering facilities, manu- 
facturing plants, sales and service branches, and 
test facilities. Because of these widely separated 
facilities, the slow delivery of vital documents by 
conventional mail often results in conununication 
problems. Also, the cost of document reproduction 
and delivery can be considerable. 1 lectronic mail 
can help solve these communication problems in 
the following ways. 

• After creation, editing, and formatting via 
WORDPRO, text is distributed instantly to recip- 
ients at many locations, thereby reducing distribu- 
tion delays and costs. 

• Online, two-way messages can be exchanged 
between Level 68/DPS users. 

• Mail can be delivered for immediate display at a 
recipient's terminal or stored in his mailbox, when 
the recipient's terminal is occupied with an urgent 
task or not logged onto the system. 

• Automatic acknowledgment-of-mail receipt can 
be requested by the sender. 

• A single, online copy of a large document can 
be maintained for remote perusal, avoiding the 
problems of reproducing and distributing [irinted 
copies, 

in addition, management of messages and docu- 
ments is aided through a variety of tools in Multics. 
Indexed, ordered archives of past messages can be 
created, searched, updated, appended, or deleted as 
desired. Tlie archives can be searched for key sen- 
tences or phrases, extra copies can be printed, and 
old messages and mail can be periodically and auto- 
matically deleted when no longer needed. 

Text can be examined and updated from several 
locations at once, lor example, (liMin;'. a i onlrael 
negolialion, a master copy ol (he conliai I tan he 
maintained online via WORDPRO. All inleiesled 
parties the customer, along with markelmg. engi- 
neering, legal, finance, etc. can simuKanetnislv 
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review and comment via electronic mail without 
the delays involved in the conventional mailing of 
contract review copies. 

SECURE MAILBOX 

The Level 68/DPS electronic mail facility utilizes a 
secure online mailbox approach. Each user can have 
a private mailbox under his home directory, or a 
group of users can share a common mailbox to 
receive mail. Tlie contents of each user's mailbox 
and archive is protected by the extensive security 
controls of the Multics virtual memory and file 

IllUIiagCillClll lUilClnjllS. VfiiCii iuan aiiivv-o tu a mov.i o 

mailbox, the recipient is immediately notified, if 
Ws terminal is online to the Level 68/DPS system. 
Tlie user can then selectively display the mail with 
simple commands, save it in mail archive files, or 
delete it. 

TYPES OF ACCESS 

Any combination of six different types of mailbox 
access can be prescribed for a single user or a group 
of users: 

• add - allows the addition of new messages to a 

:iu».. All i<^<>>.o r>»a iioaoilKr nii/ati 'm\A ntiniiiccirtn 

so they can send mail. 

• delete - allows the deletion of any message in a 
mailbox; usually retained for use only by the mail- 
box owner. 

• read - allows the user to select and read any mes- 
sages in a mailbox; usually retained for use only by 
the mailbox owner. 

• own - allows the sender to read, modify, or delete 
messages he originally sent to a mailbox, but doesn't 
allow access to other messages in the mailbox. 

• status - allows a mailbox owner to check on the 
number of his messages, their sender, length, date, 
etc., in his mailbox, without actually reading them. 

• wakeup - allows a message to be sent to a mail- 
box for immediate display, when the mailbox owner 
is accepting messages. Users can be given this permis- 
sion to allow direct, user-to-user communication. 

SIMPLE COMMANDS 

Tlie electronic mail facility utilizes standard 
Level 68/DPS system commands to send messages 
and to deliver and receive mail. Other standard file 



manipulation tools allow maintenance of online 
message and mail files. These commands can be 
issued either in full or abbreviated format. Repre- 
sentative Multics commands include: 

• mail (ml) - sends mail to another system user or 
prints the mail in the owner's mailbox. A user's 
mailbox is created automatically under the homo 
directory the first time this command is invoked. 
Optional arguments allow selective display or dele- 
tion of mail. 

• accept jnessage (am) restores the immediate 
display of messages as received; cancels the defer 
message command. 

• immediatejnessage - requests immediate display 
of any messages in an owner's mailbox or of any 
messages received while the owner's terminal is on- 
line, unless the' def^r message is in effect. 

• defeuuessage (dm) prevents any messages 
received while a iiser's terminal is online from 
immediate display and stores them in the user's 
mailbox. 

• print message (pm) - displays any messages 
received in a user's mailbox during a period when 
messages are not being accepted. 

• send message (sm) sends a messatze which is 
designated by the person and project identities 
that follow the command. 

• ,s(v/(j[_///c'.v.s</,i,'0" ^"''^*'/'''/.^''' sends a message \o 
the system user(s), designated by person and proj- 
i;^{ identifiers that follow the command. When the 
message is displayed at the recipient's terminal, an 
acknowledgment is relumed to the sender. 

SYSTEM REQUIREMENTS 

Tlie electronic mail facility is integrated with the 
other facilities of the Level 6H/1)PS. including data 
base management, text entry and editing, documenl 
formatting, list processing, artwork generation, 
photocomposition, output control, archive storage 
tools, and administrative tools. Llectronic mail Iuik- 
tions on all performance levels of the Level 68/l)rS 
system. 



Specilications may cliango as design improvements are iiilrodiu ed. 
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In 1964 planning began on the development of a proto- 
type of a computer utility. The aspirations for this system, 
named Multics (for Multiplexed Information and Comput- 
ing Service), were described in papers presented at the 
7965 Fall Joint Computer Conference. Implicit in those 
papers was the expectation of a later examination of the 
development effort. From the present vantage point, how- 
ever, it is clear that a definitive examination is beyond 
possibility in a single paper; only some of the possible top- 
ics can be discussed. First we will review the goals, history 
and current status of the appearance of the Multics system 
to its various classes of users. Finally we will describe some 
of the insights which have come out of the development 
activities. 

/MULTICS: 



The first seven years 



F. J. Corbatd 

Massachusetts Institute of Technology 

Cambridge, MA 
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FROM THE EDITOR 

This overview and history of Multics will be of excep- 
tional interest because it fills most of the requirements 
for being used as a "software factory", a term that i 
coined in 1 968. It is in fact used for that purpose within 
Honeywell Information Systems - in the construction of 
software systems. 

It is particularly pleasing to note that the punch card 
has disappeared from the view of Multics programmers, 
although not from everywhere else. As Dr. J. Rabinow 
(of Optical Character Recognition fame) has observed, 
if it does it will be the first product he has seen die while 
on an upward curve of usage! 

This article appeared in the Proceedings of the 1972 AFIPS 
Spring Joint Computer Conference, and is republished (not 
reprinted) here with the permission of AFIPS and the au- 
thors. The work reported herein was sponsored in part by 
Project MAC, an M.I.T. research program sponsored by the 
Advanced Research Projects Agency, Departfnent of De- 
fense, under Office of Naval Research Contract Number 
N00014-70-A-0362-0001. Reproduction is permitted for 
any purpose of the United States Government. 
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INTRODUCTION 

In 1964, following implementation of the Compatible Time- 
sharing System (CTSS) [1,2] serious planning began on the 
development of a new computer system specifically orga- 
nized as a prototype of a computer utility. The plans and 
aspirations for this system, called Multics (for Mu/t\p\exed 
/nformation and Computing Service), were described in a 
set of six papers presented at the 1965 Fall joint Computer 
Conference |3-8l. The development of the system was un- 
dertaken as a cooperative effort involving the Bell Telephone 
Laboratories (from 1965 to 1969), the Computer Depart- 
ment of the General Electric Company (subsequently ac- 
quired by Honeywell Information Systems Inc.), and Project 
MAC of M.I.T. 

Implicit in the 1965 papers was the expectation that there 
should be a later examination of the development effort. 
From the present vantage point, however, it is clear that a 
definitive examination cannot be presented in a single paper. 
As a result, the present paper discusses only some of the 
many possible topics. First we review the goals, history and 
current status of the Multics project. This review is followed 
by a brief description of the appearance of the Multics sys- 
tem to its various f lasses of users. Finally several topics are 
given which represent some of the research insights which 
have come out of the development activities. This organiza- 
tion has been chosen in order to emphasize those aspects of 
software systems having the goals of a computer utility 
which we feel to be of special interest. We do not attempt 
detailed discussion of the organization of Multics; that is the 
purpose of specialized technical books and papers (for ex- 
ample, the essential mechanisms for much of the Multics 
system are given in books by Organick [9] and Watson (10]). 



COALS 

The goals of the computer utility, although stated at length 
in the 1965 papers, deserve a brief review. By a computer 
utility it was meant that one had a community computer 
facility with: 

■ Convenient remote terminal access as the normal 
mode of system usage. 

■ A view of continuous operation analogous to that of 
the electric power and telephone companies. 

■ A wide range of capacity to allow growth or con- 
traction without either system or user reorganization. 

■ An internal file system so reliable that users trust their 
only copy of programs and data to be stored in it. 

■ Sufficient control of access to allow seieciive sharing 
of information, 



■ The ability to structure hierarchically both the logK al 
storage of information as well as the administration of 
the system. 

■ The capability of serving large and small users without 
inefficiency to either. 

■ The ability to support different programming environ 
ments and human interfaces within a single system 

■ The flexibility and generality of system organization 
required for evolution through successive waves of 
technological improvements and the inevitable 
growth of user expectations. 

In an absolute sense the above goals are extremely diffit ult 
to achieve. Nevertheless, it is our belief that Multics, as il 
now exists, has made substantial progress towards <k hieving 
each of the nine goals (to the best of our knowledge, the only 
other attempt to comprehensively attack all of these goals 
simultaneously is the TSS/30 project at IBM 1 1 1,12,1 )\). 
Most importantly, none of these goals had to be c()m|)r() 
mised in any important way. 



HISTORY OF THE DEVELOPMENT 

As previously mentioned, the Multics project got underw<iy 
in the Fall of 1 964. The computer equipment to hv usetf was 
a modified General Electric 635 which was later named the 
645. The most significant changes made were in the pro 
cessor addressing and access control logic where p.iging atid 
segmentation were introduced. A completely new (iener.il 
ized Input Output Controller was designed and im()lenienie<l 
to accommodate the varied needs of devices sue h as disks, 
tapes and teletypewriters without presenting an excessive 
interrupt burden to the processors. To handle lh(> expected 
paging traffic, a 4-million word (36-bit) high-perlormaiHt' 
drum system! with hardware queueing was cJev(>lop(>cl. The 
design specifications for these items were completed by I <>ll 
1965, and the equipment became available for software 
development in early 1967. 

Software preparation underwent several phases. The first 
phase was the development and blocking out of major ide.is. 
followed by the writing of detailed progr.im nfodule spec ifi 
cations. The resulting 3,000 typewritten pages formed the 
Multics System Programmer's Manual and serv(>d .us ih(> 
starting point for all programming. Furthermore, the softw.ire 
designers were expected to implement their own designs. As 
a general policy PL /I was used as the system programming 
language wherever possible to maximize lucidity mm\ main- 
tainability of the system |14, 15]. This policy also increasc>d 
the effectiveness of system programmers by allowing each 
one to ki'cp more of the system within his grasp. 

The second major f)hase of software dev<>lopni<>n!, well 
underway by early 1967, was that of module implemeni.i 
tion and unit chec kout followed by iiTcrging inlo larger ag 
gregalc^s for iniegrated lesiiiig. Dp lo then luosi soltw.ire ,uh\ 
h.udware diffic ullics h.id been .inlii ipaled on the h.isis ot 
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previDus experience. But what gradually became apparent 
as the module integration continued was that there were 
gross discrepancies between actual and expected perfor- 
mance of the various logical execution paths throughout the 
software. The result was that an unanticipated phase of de- 
sign iterations was necessary. These design iterations did not 
mean that major portions of the system were scrapped with- 
out being used. On the contrary, until their replacements 
could be implemented, often months later, they were cru- 
cidlly necessary to allow the testing and evaluation of the 
other portions of the system. The cause of the required 
redesigns was rarely "bad coding", as most of the system 
programmers were well above average ability. Moreover the 
redesigns did not mean that the goals of the project were 
compromised. Rather three recurrent phenomena were ob- 
served: 1 ) typically, specifications representing less-impor- 
tant features were found to be introducing much of the 
complexity, 2) the initial choice of modularity and interfac- 
ing between modules was sometimes awkward, and 3) it 
was rediscovered that the most important property of al- 
gorithms is simplicity rather than special mechanisms for 
unusual cases. ("In anything at all, perfection is finally at- 
tained! not when there is no longer anything to add, but when 
there is no longer anything to take away..." - Antoine de 
Saint-Exup^ry, Wind Sand <ind Stan;, Quoted with permis- 
sion of Uarcourt Brace Jovanovich, Inc.) 

The reason for bringing out in detail the above design 
iteration experience is that frequently thc» planning of large 
software projects still does not properly take the need for 
continuing iteration into account. And yet we believe that 
design iterations are a required activity on any large scale 
system which attempts to break new conceptual ground 
such that individual programmers cannot comprehend the 
entire system in detail. For when new ground is broken, it is 
usually impossible to deduce the consequent system behav- 
ior except by experimental operation. Simulation is not par- 
ticularly effective when the system concepts and user 
behavior are new. Unfortunately one does not understand 
the system well enough to simplify it correctly and thereby 
obtain a manageable model which requires less effort to 
im()lement than the system itself. Instead one must develop 
a different view: 

■ The initial program version of a module should be 
viewed only .is the first com|)lele s[)ecific.ition of the 
module and should be subject to design rc^view bohro 
being debugged or chcu kt>d out. 

■ Module (Jesign and implementation should be based 
upon ,\n assumption of periodic evaluation, redesign, 
and evolution. 

In relrospec t, the design iteration effect was apparent even 
in the development of the eadier Compatible Timesharing 
System (CTSS), when a second file system with many func- 
tional improvements turned out to have poor performance 
when initially installed. A hasty design iteration succeeded 
in rectifying the matter but the episode at the time was 
viewed as an anomaly perhaps due to inadequate technic al 
revi(>vv of individual programming efforts. 



CURRENT STATUS 

In spite of the unexpected design iteration phase, the Multics 
system became sufficiently effective by late 1 968 to allow 
system programmers to use the system while still developing 
it. By 1969 October, the system was made available for 
general use on a "cost-recovery" charging basis similar to 
that used for other major computation facilities at M.I.T. 
Multics is now the most widely used timesharing system at 
M.I.T., supporting a user community of some 500 registered 
subscribers. The system is currently operated for users 22 
hours per day, 7 days per week. Fo-- at least eight hours each 
day the system operates with two processors and thrc^e 
memory modules containing a total of 384 K (K=1024) 36- 
bit words. This configuration currently is rated at a capacity 
of about 55 fairly demanding users such that most trivial 
requests obtain response in one to five seconds. (Future 
design iterations are expected to increase the capacity rat- 
ing.) Several times a day during the off-peak usage hours the 
system is dynamically reconfigured into two systems: a re- 
duced capacity service system and an independent develop- 
ment system. The development system is used for testing 
those hardware and software changes which c.mnot be 
done under normal service operation. 

The reliability of the round-the-clock system ()()erati()n 
described above has been a matter of great concern, for in 
any online rcMl-time system the impact of misha|)s is usually 
far more severe than in batch processing systems. In an 
online system espec iaily im()ort.int considerations are: 

■ the time required before the system is usablt> agam 
following a mishap 

■ the extra precautions required for restoring possibly 
lost files 

■ the psychological stress of breaking the interactive 
dialogue with users who were counting on system 
availability 

Because of the importance of these considerations, car(>ful 
logs are kept of all Multics "crashes" (i.e., systc>m servic e 
disruption for all active users) at M.I.T. in order that analysis 
can reveal their causers. Thc^se analyses indicate c in-renily ,\n 
ave>rage of betwtx'n one ancl two c rashes f)er 24 hour d.iy.' 
These crashes have no single cause. Some are due to h.ird- 
ware failures, others to operator c^rror and still others to 
software bugs introduc cxi during the course of development. 
At the two other sites where Multics is operatecl, but where 
ac tive system development does not take place, there h.ive 
^.^v.. <.,,.iwsi ,,o ,->)r.iieiii Kihurt-s iitiCfCi icj sc)itware. 

Currently the Multics system, including compilers, com- 
mands, and subroutine libraries, consists of about 1500 
modules, averaging roughly 200 lines of PL/I apitne. These 
compile to produce some 1,000,000 words of procedure 
code. Another system measure is the si;!e of the rc^icient 
supervisor which is about 30 K words of procedure .ind, for 
a 55 user load, about 36 K words of data and buffer areas. 

Because the system is so large, the most powerful mainte- 
nance tool available^ was c hos(>n-th(> system ilself. With ,ill 
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of the system modules stored online, it is easy to manipulate 
the many components of different versions of the system. 
Thus it has been possible to maintain steadily for the last year 
or so a pace of installing 5 or 1 new or modified system 
modules a day. Some three-quarters of these changes can be 
installed while the system is in operation. The remainder, 
pertaining to the central supervisor, are installed in batches 
once or twice a week. This online maintenance capability 
has proven indispensible to the rapid development and 
maintenance of Multics since it permits constant upgrading 
of the user interface without interrupting the service. We are 
just beginning to see instances of user-written applications 
which require this same capability so that the application 
users need not be interrupted while the software they are 
^cing jc being modified. 

The software effort which has been spent on Multics is 
difficult to estimate. Approximately 150 man-years were 
applied directly to design and system programming during 
the "development-only" period of Table I. Since then we 
estimate that another 50 man-years have been devoted to 
improving and extending the system. But the actual cost of 
a single successful system is misleading, for if one starts 
afresh to build a similar system, one must compensate for the 
non-zero probability of failure. 



THE APPEARANCE OF MULTICS 
i<Li 119 uacn^ 

Having reviewed the background of the project, we may 
now ask who are the users of the Multics system and what 
do the facilities that Multics provides mean to these users. 
Before answering, it is worth describing the generic user as 
"viewed" by Multics. Although from the system's point of 
view all users have the same general characteristics and 
interface with it uniformly, no single human interface repre- 
sents the Multics machine. That machine is determined by 
each user's initial procedure coupled with those functions 
accessible to him. Thus there exists the potential to present 
each Multics user with a unique external interface. 

However, Multics does provide a native internal program 
environment consisting of a stack-oriented, pure-procedure, 
collection of PL /I procedures imbedded in a segmented vir- 
tual memory containing all procedures and data stored on- 
line. The extent to which some, all, or none of this internal 
environment is visible to the various users is an administra- 
tive choice. 



The implications of these two views-both the cxtern.il 
interface and the internal programming cnvironniicni -.src 
discussed in terms of the following categories of users: 

■ System and user application programmers responsi- 
ble for writing system and user software. 

■ Administrative personnel responsible for the m.mage- 
ment of system resources and privileges. 

■ The ultimate users of application systems. 

■ Operations and hardware maintenance personnel re- 
sponsible, respectively, for running the machiiu- 
room and maintaining the hardware. 



Multics as Viewed by System and 
Subsystem Programmers 

The machine presented to both the Multic s system program 
mer and the applic alion system i)rogramnier is the <>n(> with 
which we have the most experience; il is the raw rn.ifi-ii.il 
from which one constructs other environments. It is worth 
re-emphasi/ing that the only differentiation i)etwe»'n Mullii s 
system programmers and user [)rogramm(>rs is embodied m 
the access control mechanism which determines what on 
jip_M information can be referenced; theretore, wh.tt .ire .ip 
parently two grou|)s of users can be disc usschI .»s one. 

Major interfaces prt^sentc^d to programmers on the Mullic s 
system can be classified as the program preparation i\ni\ 
documentation facilities and the program execution and 
debugging environment. They will be touched upon bric^flv. 
in the order used for program preparation. 



■ Program Preparation and Documentation 

The facililic^s for program preparation on Mullic s .ire typu a! 
of those found on othc^r timesharing systems, with some 
shifts in emphasis. (See the Appendix.) for e\ampl(\ pro 
grammers consider the file system suffic iently invu!ner.ih!(> 
to physic al loss thai il is used c asually Ain\ roulmel^' to save 
all information. Thus, the punch(>cl c ard has vanished liom 
the work routine of Multics programmers ,\m\ access to 
one's programs and the ability to work on them are piovided 
by the c losc>sl terminal. 



System 

CTSS 

Multics 



Development Only 
1960-1963 
1964-1969 



Development + Use 
1963-1965 
1 969-present 



Use Only 



1 965-present 



Table I. A comparison of the system cJevelopment and use periocis of CTSS and Muhics. The Multics development period Is not siBnificanlly longer th.in 
that for CTSS despite the development of about 10 limes as much code for Multics as for CTSS and a geographically distributed staff. Although reasons 
for this similarity in time span include the use of a higher-level programming language and a somewhat larger staff, the use of CTSS as a dovdopnu-nl t<H)l 
for Multics was of pivotal importance. 
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AS .inothor example, the full ASCII character set is em- 
ployed in preparins programs, data, and documentation 
th(.re[)y eliminating the net^d for multiple text editors several 
varieties of text formatting and comparison programs, and 
multiple facilities for printing information both online and 
offline. This generalization of user interfaces facilitates the 
learning and subsequent use of the system by reducing the 
number of conventions which must be mastered. 

Finally, because the PL/ 1 compiler is a large set of pro- 
grams, considerable attention was given to shielding the user 
from the size of the compiler and to aiding him in mastering 
the complexities of the language. As in many other timeshar- 
ing systems, the compiler is invoked by issuing a simple 
command line from a terminal exactly as for the less ambi- 
tious commands. No knowledge is required of the user re- 
garding the various phases of compilation, temporary files 
required, and optional capabilities for the specialist; explana- 
tory sermons" diagnosing syntactic errors are delivered to 
the terminal to effect a self-teaching session during each 
compilation. To the programmer, the PL/I compiler is just 
another command. 



■ Program Execution Environment 

Another set of interfaces is embodied in the implementation 
environment seen by PL/I programmers. This environment 
consists of a directly addressable virtual memory containing 
the entire hierarchy of online information, a dynamic linking 
facility which searches this hierarchy to bind procedure ref- 
erences, a device-independent input/output (16| system 
(the Michigan Terminal System (171 has a similar device- 
mdependent input/output system) and program debugging 
and metering facilities. These facilities enjoy a symbiotic 
relationship with the PL/I procedure environment used both 
to implement them and to implement user facilities co-exist- 
ing with them. Of major significance is that the natural inter- 
nal environment provided and required by the system is 
exactly that environment expected by PL/I procedures For 
example, PL/i pointer variables, call and return statements 
conditions, and static and automatic storage all correspond 
directly to mechanisms provided in the internal environ- 
ment. Consequently, the system supports PL/I code as a 
matter of course. 

The main effec t of the combination of thes(> fixtures is to 
permit the implementer to spend his time concentrating on 
the logic of his problem; for the most part he is freed from 
the usual mechanical problems of storage management and 
overlays, input/output device quirks, and machine-depend- 
ent features. 



procedures and about 125 K words of object code Four 
people implemented this compiler in two years, from start to 
^rst general use. The first version of the Multics program 
debugging system, composed of over 3,000 lines of source 
code, was usable after one person spent some six months of 
nights and weekends "bootlegging" its implementation As 
a ast example, a facility consisting of 50 procedures with a 
total of nearly 4,000 PL/I statements permitting execution of 
Honeywell 635 programs under Multics became operational 
after one person spent eight months learning about the 
GCOS operating system for the 635 PL/I, and Multics and 
then implemented the environment. In each of these exam- 
ples the implementation was accomplished from remote ter- 
minals using PL/I. 

Multics users have discovered that it is possible to get their 
programs running very quickly in this environment They 
frequently prepare "rough drafts" of programs, execute 
them, and then improve their overall design and operating 
strategy using the results of experience obtained during ac 
tual operation. As an example, again drawn from the imple- 
mentation of Multics, the early designs and implementations 
of the programs supporting the virtual memory 1181 made 
over-optimistic use of variable-sized storage alloc ation tech- 
niques. The result was a functionally correct but inacJe- 
quately performing set of programs. Nevertheless these 
modules were used as the foundation for subsc>quenl work 
for many months. When they were finally repLuc>d with 
modules using simplified fixed-size storage tec hniques per- 
formance improvements of over an order of magnilucle worc> 
realized This technique emphasizes two points: first it ,s 
frequently possible to provide a pracfica}, mable facility c on- 
ta.ning temporary versions of programs; second, often the 
insight required to significantly improve the behavior of a 
program comes only after it is studied in operation. As im- 
plied in the earlier discussion of design iteration, our experi- 
ence has been that structural and strategic changc-s rathcv 
than polishing (or receding in assembly language) produce 
the most significant performance improvements 
In general, we have noticed a significant "amplifier" or 
leverage effect with the use of an effective online environ- 
ment as a system programming facility. Major implementa- 
lon projects on the Multics system seldom involve more 
than a few programmers, thereby easing the management 
and communications problems usually entailed l,y c ompU^x 
system implementations. As would be expected, the- amphf,- 
ca ion effect is most apparent with the best f,ro,c.c t pc>rson- 



■ Some Implementation Experience 

The Multics team began to be much more f)rodu( tive one e 
the Multics system became useful for software developmcMit 
A tew c ases are worth citing to illustrate the effec tiveness of 
the implementation environm(>nt. A good example- is the 
current PL/I compiler, which ,s the third one to be imple- 
mented for the project, and whic h t onsisis of som(> 250 



Administration of Multics 
Facilities and Resources 

The problem of managing the capabil.tic.s of ., compulc-r 
utility with geographically dispc-rscnl subscribc-rs IcmcK to . 
requM-ement of decentralized administration. At the- apc-x o'f 
an administrative pyramid resides a system adn.ini ,r.m,r 
with the ability to register new users, confer resource quotas 
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and generate periodic bills for services rendered. The system 
administrator deals with user groups called projects. Each 
group can in turn designate a project administrator who is 
delegated the authority to manage a budget of system re- 
sources on behalf of the project. The project administrator 
is then free to deal directly with project members without 
further intervention from the system administrator, thereby 
greatly reducing the bottlenecks inherent in a completely 
centralized administrative structure. 



■ Environment Shaping 

In addition to having immediate control of such resources as 
secondary storage, port access, and rate oi processor usage, 
the project administrator is also able to define or shape the 
environment seen by the members of his project when they 
log into the system. He does this by defining those proce- 
dures that can be accessed by members of his project and 
by specifying the initial procedure executed by each mein- 
ber of his project when he logs in. This environment shaping 
facility has led to the notion of a private project subsystem 
on Multics. It combines the administrative and programming 
facilities of Multics so that a project administrator and a few 
project implementers can build, maintain, and evolve envi- 
ronments entirely on their own. Thus, some subsystems bear 
no internal resemblance to the standard Multics procedure 
environment. 

For example, the Dartmouth BASIC |19| compiler exe- 
cutes in a tjosed subsystem im|)lemente(l by ^m M.I.T. stu- 
dent group for use by undergraduate students. The compiler, 
its object code, and all support routines execute in a simula- 
tion of the native environment prtjvided ,\\ DartiTiouth. The 
users of this subsystem ne^ed little, if any, knowledge of 
Multics and are able to behave as if logged into the Dart- 
mouth system proper. Other examples of controlled envi- 
ronment subsystems include one to permit many programs 
which normally run under the CCOS operating system to 
also run unmodified in Multics. Finally, an APL |20| subsys- 
tem allows the user to behave for the most part as if he were 
logged into an APL machine. The significance of these sub- 
systems is that their implementers did not need to interact 
with the system administrator or to modify already existing 
Multics capabilities. The administrative facilities permit each 
such subsystem to be offered by its supporters as a private 
service with its own group of users, each effectively having 
its own private computer system. 



Other Multics Users 

Finally, we observe that the roles of the application user, the 
system operators and the hardware mainlainers as seen by 
the system are simply those of ordinary Multics users with 
specialized access to the online procedures and data. The 
effec t of this uniformity of trcMtment is lo reduce grcMtiy the 
maintt>naiH(> burden of tln^ system control software. One 
example, ot great practical importance*, has Invn the cMse 
with which system perfornianc c measuremenl tools have 
been prepared for use by the o[)c>rating siafl. 



INSIGHTS 

So far, we have discussed the status and appearance of the 
Multics system. A further question is what has been learned 
in the construction of Multics which is of use to the designers 
of other systems. Having a bright idea which c learly solves 
a problem is not sufficient cause to claim a contribution if the 
idea is to be part of a complex system. In order to establish 
the real feasibility of an idea, all of its implications and conse- 
quences must be followed out. Much of the work on Multics 
since 1 965 has involved following out implications and con- 
sequences of the many ideas then proposed for the proto- 
type computer utility. That following out is an essential part 
of proof of ideas is attested by the difficulties which have 

VJCil «JI IV-V^UI lltt %^V-J III *^U iCi "Ul i^ll i\_s_l II 1^ \^ti\jtK.y .»\jr\_»t «.»> ii.^ 

development of nuclear fusion power plants and the electric 
automobile. Not all proposals work out; for example, ex- 
tended attempts to engineer an atomic powered airplane* 
suggest infeasibility. 

Perhaps Multics' most significant single contribution to the 
state of the art of computer system construction is the dem- 
onstration of a large set of fully implemented idcMs in a 
working system. Further, most of these ideas have bc»en 
integrated without straining the overall design; most addi- 
tional proposals would not topple the structure. IdtMS such 
as virtual memory access to online storage, parallel process 
organization, routine but controlled information sharing, dy- 

„,~:,- l:„l.:„„ „f . J ^ ,„J W.r^U l„.„>l U««.(,r.^ :rv>r>l,. 

iidiiiic iiiiMiig ui (Jiwccuuica, aiiu iiigii-icvci lai i^uapu mm(/iv- 

mentation have proven remarkably compatible and 
complementary. 

To illustrate some of the areas of progress in understanding 
of system organization and construction which have been 
achieved in Multics, we consider here the following five 
topics: 

■ Modular division of responsibility 

■ Dynamic reconfiguration 

■ Automatically managed multilevel memory' 

■ Protection of programs and data 

■ System programming language 



Modular Division of Responsibility 

Early in the design of Multics a decision had to be made 
whether or not to treat the segmented virtual memory as a 
separately usable "feature", independent of a traditionally 
organized read /write type file system. The alternative, to use 
the segmented virtual memory as the file system itself, pro- 
viding the illusion of direct "in-core" access to all online 
storage, was certainly the less conservative approach (Fig. 
1 ). The second approach, which was the one chosen, led to 
a strong test of the ability of a computing system to support 
an apparent one-level memory for an arbitrarily large infor- 
mation base. It is interesting that the resulting almost total 
decoupling between physical storage allocation anci data 
movement on the one hand and directory structure, naming, 
and file organization on the other led to a remarkably simple 
,\\u\ func tionally modular structure* for that |)arl of the* system 
|18|(fig. 2). 
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Figure 1. The entire sloraRe hierarchy may be mapped into Individual user 
process address spaces (see arrows) as if contained in a primary memory. 
Illuslratwl are llu* sharing of a supervisor segment by two users and private 
access to segmetils a and b. The necessary primary storage is simulated by 
a demand paging technique which moves information between the real 
primary memory aiid secondary storage. 
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Figure 2. Major lines of mcKlular division in Mullics. Solid lines indicate 
tails lor services. Dotted line's indicate impliul use of (he virtual memory. 



Another' area of Multics in which a high degree of func- 
tional modularity was achieved was in scheduling, multipro- 
gramming, and processor management. Because harnessing 
of multiple processors was an objective from the beginning, 
a careful and methodical approach to multiplexing pro- 
cessors, handling interrupts, and providing interprocess syn- 
chronizing primitives was developed. The resulting design, 
known as the Multics traffic controller, absorbed into a sin- 
gle, simple module a set of responsibilities often diffused 
among a scheduling algorithm, the input/output controlling 
system, the online file management system, and special pur- 
pose inter-user communication mechanisms (21). 

Finally, with processor management and online storage 
management uncoupled into well-isolated modules, the 
Multics input/output system was left with the similarly isola- 
table function of managing streams of data flowing from and 
to source and sink type devices [ 1 6). Thus, this section of the 
system concentrates only on switching of the slriMins, alio 
cation of data buffering areas, and device control strategics. 

Each of the divisions of labor described above represents 
an interesting result primarily because it is so difficult to 
discover appropriate divisions of complex systems. (See 
Dijkstra [22] for a further discussion of this point). Establish- 
ing that a certain proposed division results in simplicity, 
creates an uncluttered interface, and does not interfere with 
performance, is generally cause for a minor celebration. 



Dynamic Reconfiguration 

if the computer utility is ever to become as much a rcMlily 
as the electric power utility or the telephone communication 
service, its continued operation must not be dependent upon 
any single physical component, since individual comf)onents 
will eventually require maintenance. This observation leads 
an electric power utility to provide procedures wherel)y an 
idle generator may be dynamically added to the utility's 
generating capacity, while another is removed for m,nnt(> 
nance, all without any disruption of service to c usioiners. A 
similar scenario has long been proposed for multiprocessor, 
multimemory computer systems, in which one would 
dynamically switch processors and memory boxes in and 
out of the operating configuration as needed. Unfortunately, 
though there have been demonstrated a few "special pur- 
pose" designs (an outstanding example is the American Air- 
lines SABRE system [23]) it has not been apparent how to 
provide for such operations in a general purpose system. A 
recent thesis [24] proposed a general model for the dynamic 
binding and unbinding of computation and memory struc- 
tures to and from ongoing computations. Using this model 
as a basis, the thesis also proposed a specific implementation 
for a typical multiprocessor, multimemory computing sys- 
tem. One of the results of this work was the addition to the 
operating Multics system of the capability of dynainically 
adding and removing central processors and memory 
modules as in Figure ,3. The usefulness of the icJea may be 
gauged by observing that at M.I.T. five to ten such reconfigu- 
rations are perforine^d in a typical 24-hc)ur operating clay 
Most of the reconfigurations are used to provide a secondary 
system for Multics developinent. 
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a A strategy to treat core memory, drum, and disk as a 
three-level system has been proposed, including a "least- 
recently-used" algorithm for moving information from 
drum to disk. Such an algorithm has been used for some 
time to determine which pages should be removed from 
core memory [271. The dynamics of interaction among 
two such algorithms operating at different levels are 
weakly understood, and some experimental work should 
provide much insight. The proposed strategy will be im- 
plemented, and then compared with the simpler present 
strategy which never moves things from drum to disk, 
but instead makes educated "guesses" as to which de- 
vice is most appropriate for the permanent residence of 
a given page. If the automatic algorithm is at least as good 
as the older, static one, it would represent an improve- 
ment in overall design by itself, since it would automati- 
cally track changes in user behavior, while the static 
algorithm requires attention to the validity of its guesses. 

■ A scheme to permit experimentation with predictive 
paging algorithms was devised. The scheme provides for 
each process a list of pages to be preloaded whenever 
the process is run, and a second list to be immediately 
purged whenever the process stops. The updating of 
these lists is controlled by a decision table exorcised 
every time the process stops running. As every page of 
the Multics virtual memory is potentially shared, the de- 
cision table represents a set of heuristics clesigned to 
separate out those which are probably not being shared 
at the moment. 

■ A series of measurements was made to establish the 
effectiveness of a small hardware associative memory 
used to hold recently accessed page descriptors These 
measurements established a profile of hit ratio (proba- 
blity of finding a page descriptor in the associative mem- 
ory) versus associative memory size which should be 
useful to the designer of virtual memory systems (28). 



Automatically Managed Multilevel Memory 

By now it has become accepted lore in the computer system 
field that the use of automatic management algorithms for 
memory systems constructed of several levels with different 
access times can provide a significant reduction of user pro- 
gramming t^ffort. Examples of such .lutomatic management 
strategies include the buffer memories of the IBM system 
;i7() models 1 55, 1 (>5, and 1 95 |25l and the demand paging 
virtual memories of Multics, IBMs CP-()7 |26| and the Michi- 
gan Terminal System 117). Unfortunately, behind the mask 
of acceptance hides a worrisome lack of ktiowledge al)out 
how to engineer a multilevel memory system with appropri- 
ate strategy algorithms which are matched to the load and 
hardware* characteristics. One of the goals of the Multics 
projtH! has Ihmmi to inslrutin-nt ,vm\ exf)e!imenl with th<> 
multilevel memory system of Miiltic s, in order lo te.un biMler 
how lo predict in advance* the perforiiuuut' of proposed 
new .tulom.itically managed nuiliilevel inemorv sysUnis 
Several sfu^cific as()ects of this goal have i)een ex|)lf)rod: 



■ A set of models, both analytic and simulation, was con- 
structed to try to understand program behavior in a vir- 
tual memory. So far, two results have been obtained. 
One is the finding that a single program characteristic 
(the mean execution time before encountering a "miss- 
ing" page in the virutal memory as a function of memory 
size) suffices to provide a quite accurate prediction of 
paging and idle overhead times. The second is a direct 
calculation of the distribution of response times under 
multiprogramming. Having available the entire response 
time distribution, rather than just averages, permits esti- 
mation of the variance and 90-percentile points of the 
distribution, which may be more meaningful than just the 
average. A doctoral thesis is in progress on this topic. 

Although the immediate effect of each of these investij^a- 
tions is to improve the understanding or performance of the 
current version of Multics, the long-range |)ayoff in inelhodi 
cal engineering using belter understood memory situt Hires 
is also evident. 



10 HONEYWELL COMPUTER JOURNAL 



c-a 



Protection of Programs and Data 

A long-standing objective of the public computer utility has 
been to provide facilities for the protection of executing 
programs from one another, so that users may with confi- 
dence place appropriate control on the release of their pri- 
vate information. In 1967, a mechanism was proposed [29] 
and implemented in software which generalized the usual 
supervisor-user protection relationship. This mechanism, 
named "rings of protection", provides user-written subsys- 
tems with the same protection from other users that the 
supervisor has, yet does not require that the user-written 
subsystem be incorporated into the supervisor. Recently, 
this approach was brought under intense review, with two 
results: 

■ A hardware architecture which implements the 
mechanism was proposed [30]. One of the chief fea- 
tures of the proposed architecture is that subroutine 
calls from one protection ring to another use exactly 
the same mechanisms as do subroutine calls among 
procedures within a protection area. The proposal 
appears sufficiently promising that it is included in the 
specifications for the next generation of hardware to 
be used for Multics, 

■ As an experiment in the feasibility of a multilayered 
supervisor, several supervisor procedures which re- 
quired protection, but not all supervisor privileges, 
were moved into a ring of protection intermediate 
between the users and the main supervisor. The suc- 
cess of this experiment established that such layering 
is a practical way to reduce the quantity of supervisor 
code which must be given all privileges. 

Both of these results are viewed as steps toward first, a more 
complete exploitation and understanding of rings of protec- 
tion, and later, a less constrained organization of the type 
suggested by Evans and LeClerc [31] and by Lampson [32]. 
But more importantly, rings of protection appear applicable 
to any computer system using a segmented virtual memory. 
Two doctoral theses are underway in this area. 



System Programming Language 

Another technique of system engineering methodology be- 
ing explored within the Multics project is that of higher level 
programming language for system implementation. The ini- 
tial step in this direction (which proved to be a very big step) 
was the choice of the PL/I language for the implementation 
of Multics. By now, Multics offers an extensive case study 
m the viability of this strategy. Not only has the cost of using 
a higher level language been acceptable, but increased main- 
l.iin.ibilily of the software has permitted tnor(> rapid evolu- 
tion of the system in response to develofMuenl ideas as well 
as user ne(>ds. Three specific .ispec ts of this experienc c> have 
now h(«(>n c ()ni()lt'led. 



■ The transition from an early PL/I subset compiler [ 1 4 1 
to a newer compiler which handles almost the entire 
language was completed. This transition was ( arried 
out with performance improvement in prac tically t^v- 
ery module converted in spite of the larger language 
involved. The significance of the transition is the 
demonstration that it is not necessary to narrow one's 
sights to a "simple" subset language for system pro- 
gramming. If the language is thoroughly understood, 
even a language as complex as the full PL/ 1 can be 
effectively used. As a result, the same language .\nd 
compiler provided for users can also be used for 
system implementation, thereby minimizing mainte- 
nance, confusion, and specialization. 

■ Notwithstanding the observation just made, the time 
required to implement a full PL/ 1 compiler is still too 
great for many situations in which the compiler im- 
plementation cannot be started far enough in ad- 
vance of system coding. For this reason, there is 
considerable interest in defining a smaller language 
which is easily compilable, yet retains tht> features 
most important for system implementation. On the 
basis of the experience of programming Multic s in a 
subset of PL /I, such a language was defincnl but not 
implemented, since it was not ntn^ied \U\. 

■ A census of Multics system modules reve.ils how 
much of the system was actually coded in PL/ 1, and 
reasons for use of other languages. Roughly, of the 
1500 system modules, about 250 wert* wrttltni m 
machine language. Most of the machine language 
modules represent data bases or small sul)roulines 
which execute a single privileged instruction. (No at- 
tempt was made to provide either a data base com- 
piler or PL/I built-in functions for specialized 
hardware needs.) Significantly, only a half dozen 
areas (primarily in the traffic controller, the central 
page fault path, and interrupt handlers) which were 
originally written in PL/I have been recoded in ma- 
chine language for reasons of squeezing out the ut- 
most in performance. Several programs, originally in 
machine language, have been recoded in PI /I to in- 
crease their maintainability. 

As with the earlier to[)ics, the implications of this work with 
PL/I should be felt far beyond the Multics system. Most 
implementers, when faced with the economic uncertainties 
of a higher-k»vel language, have chosen mac hine language 
for their central operating systems. Th(> experience of using 
PL/I .or Multics, when adckxi io the expanciing coIIch (ioti of 
experience elsewhere |34|, should help rc^luce the uncer- 
tainty. 

In a research projec t as largc\ long, and complc^x as Mul- 
tics, any paper such as this must necessarily omit m,uiy 
(Kjually signific ant ideas, .uid louc h only a few whic h may 
happen Io h.ive wide < urrenl inleiesl. it is the purpose ol 
individu.il and del. tiled lee Iuik ,iI p.ipi-is h) e^pl.im ihese .iiid 
other ideas mow fully. I he bibliography found ir) leleieiu e 
I {""il contains over Iwenlv such technical pa[)ers. 
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IMMEDIATE FUTURE PLANS 

The Multics software is continuing to evolve in response to 
user needs and improved understanding of its organization. 
In 1 972 a new hardware base for Multics will be installed by 
the Information Processing Center at M.I.T. for use by the 
M.I.T. computing community. This program compatible 
hardware base contains small but significant architectural 
extensions to the current hardware. The circuit technology 
used will be that of the Honeywell 6080 computer. The 
substantial changes include: 

■ Replacement of the paging drum initially with bulk 
core and, when available, LSI memory. 

■ Implementation of rings of protection as part of the 
paging and segmentation hardware. 

Wherever possible the strategy of using off-the-shelf stan- 
dard equipment rather than specially engineered units for 
Multics has been followed. This strategy is intended to sim- 
plify maintenance. 



CONCLUSIONS 



■ the TENEX system of Bolt, Beranek and Newman 

■ the VENUS system of Mitre Corp. 

■ the MU5 at Manchester University 

■ RC-4000 of Regnecentralen 

■ 5020 TSS of Hitachi Corp. 

■ DIPS-1 of Nippon Telephone 

■ the Japanese National Computer Project 

■ the PDP-10/50 TSS of Digital Equipment Corp. 

■ the CBB-500 of Berkeley Computer Corp. 

■ I.T.S. of the M.I.T. Artificial Intelligence Laljor.itory 

■ Exec-8 of Univac 

■ System 3 and 7 and the SPECTRA. 70/4(i of RCA 

■ Star-IOOof CDC 

■ UTS of Xerox Data Systems 

■ the 6700 system of Burroughs 

■ the Dartmouth Timesharing System 

In most cases, their designers have developed effective i,in- 
plementations which are directed to a different interpreta- 
tion of the goals, or to a smaller set of goals than those 
required for the complete computer utility. This diversity is 
valuable, and probably necessary, to accomplish a thorou^^h 
exploration of many individually complex icleas, and th(»reby 
to meet a future which holds increasing demand for systems 
which embrace the totality of computer utility rec^uirentents. 



There are many conclusions which could possibly be drawn 

c .u„ : — ^^ ^c tu^ kx..i»:^,- r^,^:..,.,-* r\( »U»r,-> ...r^ 

IHJIII IIIC CApCIICIIV-C Ul llIC PVIUHH.3 ^/H^JCV-I. V^l HIC3t, vn. 

consider four to be major and worthy of note. First, we feel 
it is clear that it is possible to achieve the goals of a prototype 
computer utility. The current implementation of Multics pro- 
vides a measure of the mechanisms required. Moreover, the 
specific implementation of the system, because it has been 
written in PL/ 1, forms a model for other system designers to 
draw upon when constructing similar systems. 

Second, the question of whether or not the specific soft- 
ware features and mechanisms which were postulated for 
effective computer utility operation are desirable has now 
been tested with specific user experience. Although the spe- 
cific mechanisms implemented subsequently may be super- 
seded by better ones, it is certainly clear that the 
improvement of the user environment which was wanted 
has been achieved. 

Third, systems of the computer utility class must evolve 
indefinitely since the cost of starling over is usually prohibi- 
tive and the many-year lead time required may be equally 
unacceptable. The requirement of evolvability places strin- 
gent demands on design, maintainability, and implementa- 
tion techniques. 

Fourth and finally, the very act of creating a system which 
solves many of the problems posed in 1 965 has opened up 
many new directions of research and development. It would 
appear almost a certainty that increased user aspirations will 
continue to require intensive work in the areas of computer 
system principles and techniques. 

in closing, perhaps we should take note that in the seven 
years since Multics was proposed, a great many other sys- 
tems have also been proposed and constructed; many of 
these have developed similar ideas. Some examples which 
have not already been mentioned include: 



It is impossible to acknowk^dge accurately the c onlrihutions 
of all the individuals or even the several organisations whic h 
have given various forms of support to the cievelopmeni of 
Multics over the past seven years. As would be expected ot 
any multiorganization project spanning several ye.irs, iherc> 
has been a turnover in the personnel involved. As ihi> indi 
vidual contributors now number in the hundreds, f)r(>per 
recognition cannot be given here. Instead, since the (fevel- 
opment of significant features and designs of Multics has 
occurred in specific areas and disciplines such as infuil/out- 
put, virtual memory design, languages, and resource multi- 
plexing, a more accurate delineation of achievements shouki 
be made in specialized papers. So in the end we must defer 
to the authors of individual papers, past and future, to ac- 
knowledge the efforts of some of the many contributors who 
have made the evolution of Multics possible 



APPENDIX: A CHECKLIST OF 
MULTICS FEATURES 

Following is a c hecklist of ( urrenlly .wailable features ,\\v,\ 
facilities of Mullic s. Although many of the features are de 
scribed in cryptic and unlr.jnsl.iled local j.ir^on, one ( ,\\\ ,\\ 
least obtain a fc»el for ihe r.inge of f.ic ililic>s now provided 
Further information on most of ihese features m.iy he (ound 
in the Multics Programmers' Manual [JSj. 
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CHECKLIST OF MULTICS FEATURES 

Interactive Time-Sharing Facilities 

■ file editors 

■ file manipulation (rename/ move/delete) 

■ personal command abbreviations 

■ recursive command language 

■ source language debugging with breakpoints 

■ subroutine call tracer 

■ can stop any running command or program 

Programming Languages 

■ PL/I 

■ FORTRAN 

■ BASIC (The BASIC system and the Dartmouth envi- 
ronment were developed at Dartmouth College. 
Used at M.I.T. by permission of Dartmouth College.) 

■ APL 

■ LISP 

■ BCPL 

■ ALM (assembly language/ Multics) 



Management l-acilities 

■ passwords required for login 

■ project may interpose authentication procedure 

■ decentralized projects , 

■ accounting, billing, and quotas 

■ online probing and account adjustment 

■ operator or system initiated logout of users 

■ unlisted and anonymous users 

■ limited service system 

■ dynamic reconfiguration of memories and processors 

■ system performance metering for parameter adjust- 
ment 

• project-imposed starting procedure 

Communication Facilities 

■ interuser mail 

■ help command, help files 

■ message of the day 

■ online error reporting and consultation servic e 

■ online user graffiti board 

■ operations message broadcast to logged-in users 



Information Storage System 

■ configuration independent 

■ accessed through virtual memory (segments) 

■ access control lists by user and project 

■ links to segments of other users 

■ hierarchical directory (catalog) arrangements 

■ public library facilities 

■ sharing at all levels 

■ multiple segment names (synonyms) 

■ separate control of read, write, and execute 



Programming Environment 

■ segmented virtual memory 

■ dynamic linking of procedures and data, or prelinking 

■ interprocess communication 

■ independent of configuration 

■ uniform error handling mechanism 

■ user definable protection rings 

■ microsecond calendar clock with interrupt 

■ program interrupt signal from console 



Absentee Facilities 

■ priority/defer queues for printer, card punch 

■ queued translator facility 

■ general absentee job facility 

Reliability Measures 

■ weekly file copies onto tape 

■ daily disk/drum copy onto tape 

■ incremental file copies onto tape, 1/2 hour behind 
use 

■ salvager to clean up files after system crash 

■ emergency shutdown entry to system 

Maintenance Features 

■ online library change, no disruption of current users 

■ entire system source online, maintenance tools 

■ system checkout on small hardware configuration 

■ online performance monitoring of multiprogramming 
(paging traffic; drum/disk usage; typewriter traffic) 

■ user performance feedback (cpu time and paging 
load on each command; page trace always operating; 
subroutine call counters) 



Input and Output 

■ standard typewriter interface for device indepen- 
dence 

■ ASCII character set used throughout 

■ input characters converted to canonical form 

■ erase and kill editing on typed input 

■ I/O streams switchable during execution 

■ magnetic tape, printer, card punch, card reader 

■ typewriter terminals (IBM 2741, 1050; Teletype 37, 
33, 3S; Dura; Datel; Execuport; Terminet-300) 

■ graphic support library (devices: ARDS, IMLAC, DEC 
338) 

■ ARPA network 

■ interfaces at three levels (formatted data coversion; 
bit stream control; full device control) 



Private Project Subsystems 

■ project-providable command interface 

■ Dartmouth environment (The BASIC system and the 
Dartmouth environment were developed at Dart- 
mouth College. Used at M.I.T. by permission) 

■ student environment 



Miscellaneous Facilities 

■ desk calculators 

■ sort command 

■ memorandum formatting and typing subsystem 

■ user-provided list of prografiis to l)e .uitomalitally 
executed when user logs iti 

■ GCOS environment 
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This is the information that a new Multics programmer 
receives when he becomes a user at M.I.T. (or else- 
where). This should be of interest in view of impending 
upgrading of the system. 

The next issue of the Honeywell Computer Journal 
will carry a special microfiche devoted to a historical 
potpourri of the major papers on Multics. 



Introduction 

Multics (from Multiplexed Information and Computing 
Service) is the name of a new, general-purpose computer 
system developed by the Computer System Researc h group 
at M.I.T. Project MAC, in cooperation with Honeywell Infor- 
mation Systems (formerly the General Electric Company 
Computer Department) and the Bell Telephone Laborato- 
ries. This system is designed to be a "computer utility", 
extending the basic concepts and philosophy of the Comp.it- 
ible Timesharing System (CTSS, operating now on the IBM 
7094 computer) in many directions. Multics is implementtni 
initially on the Honeywell 645 computer system, an en- 
hanced relative of the Honeywell 635 computer. 

One of the over-all design goals of Multics is to ( reale a 
computing system which is capable of meeting almost ail of 
the present and near future requirements of a large comfjuter 
utility. Such systems must run continuously and reliably 7 
days a week, 24 hours a day, in a way similar to telephone 
or power systems, and must be capable of meeting wide 
service demands: from multiple man-machine interaction to 
the sequential processing of absentee user jobs; from the use 
of the system with dedicated languages and subsystems to 
the programming of the system itself; and from centralized 
bulk card, tape, and printer facilities to remotely located 
terminals. Such information processing and communication 
systems are believed to be essential for the future growth of 
computer use in business, in industry, in government and in 
scientific laboratories, as well as stimulating applications 
which would otherwise be untried. 

Because the system must ultimately be comprehensive 
and able to adapt to unknown future requirements, its frame- 
work must be general, and capable of evolving with lime. As 
brought out in the sequel, this nt^ed for an evolutionary 
framework influences and contributes to much of the system 
design and is a major reason why most of the programming 
of the system has been done in a subset of the PL /I language. 
Because the PL/! language is largely machine-independent 
(e.g., data descriptions refer to logical items, not physical 
words), the system should also be. Specifically, it is hoped 
that future hardware improvements will not make system 
and user programs obsolete and that implementation of the 
entire system on other suitable computers will rtK|uire only 
a moderate amount of additional programming. 

As computers have matured during the last two dec ades 
from curiosities lo cak ulating machines to information [)ro 
c essors, ac cess lo them by users has not improved, .uul, in 
the cas(> of most large mai hines, has retrogressed I'riiu i 
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pally for economic reasons, batch processing of computer 
jobs has been developed and is currently practiced by most 
large computer installations, and the concomitant isolation 
of the user from elementary cause-and-effect relationships 
has been either reluctantly endured or rationalized. For sev- 
eral years a solution has been proposed to the access prob- 
lem. This solution, usually called timesharing, is basically the 
rapid time-division multiplexing of a central processor unit 
among the jobs of several users, each online at a typewriter- 
like terminal. The rapid switching of the processor unit 
among user programs is, of course, nothing but a particular 
form of multiprogramming. 

The impetus for timesharing first arose from professional 
programmers because of their constant frustration in debug- 
ging programs at batch processing installations. Thus, the 

neous access by several persons while giving to each of them 
the illusion of having the whole machine at his disposal. This 
goal led to the development of the Compatible Timesharing 
System (CTSS) at M.I.T. Project MAC. However, at Project 
MAC it has turned out that simultaneous access to the ma- 
chine, while obviously necessary to the objective, has not 
been the major ensuing benefit. Rather, it is the availability 
at one's fingertips of facilities for editing, compiling, debug- 
ging, and running programs in one continuous interactive 
session that has had the greatest effect on programming. 
Professional programmers are encouraged to be more imagi- 
native in their work and to investigate new programming 
techniques and new problem approacnes wecause Oi tuC 
much smaller penalty for failure. But, the most significant 
effect that CTSS has had on the M.I.T. community is seen in 
the achievements of persons for whom computers are tools 
for other objectives. The availability of CTSS not only has 
changed the way problems are attacked, but has caused 
important research to be undertaken that otherwise would 
not have been done. As a consequence, the objective of the 
current and future development of timesharing extends 
beyond the improvement of computational facilities with 
respect to traditional computer applications. Rather, it is the 
online use of computers for new purposes and in new fields 
which provides the challenge and the motivation to the sys- 
tem designer. In other words, the major goal is to provide 
suitable tools for what is currently being called machine- 
aided cognition. 

More specifically, the importance of a multiple-access 
system operated as a computer utility is that it allows a vast 
enlargement of the scope of computer-based activities, 
which can, in turn, stimulate a corresponding enrichment of 
many areas of our society. Over six years of experience 
indicates that continuous operation in a utility-like manner, 
with flexible remote access, encourages users to view the 
system as a thinking tool in their daily intellectual work. 
Mechanistically, the qualitative change from the past results 
from the drastic improvement in access time and conve- 
nience. Objectively, the change lies in the user's ability to 
control and affect interactively the course of a process 
whether it involves numerical computation or manipulation 
of symbols. Thus, parameter studies are more intelligently 
guided; new problem-oriented languages and subsystems 
are developed to exploit the interactive capability; m.iny 



complex analytical problems, as in magnetohydrodynamics, 
which have been loo cumbersome to be tackled in the past, 
are now being successfully pursued; even more, new, imagi- 
native approaches to basic research have been developed, 
as in the decoding of protein structures. These are examples 
taken from an academic environment; the effect of multiple- 
access systems on business and industrial organizations c an 
be equally dramatic. It is with such new applications in mind 
that the Multics system has been developed. Not that the 
traditional uses of computers are being disregarded: rather, 
these traditional needs are viewed as a subset of the broader, 
more demanding, new requirements. 

To meet the above objectives, issues such as response 
time, convenience of manipulating data and programs, ease 
of controlling processes during execution, and, above all, 
protection of private information and isolation of indepen- 
dent processes, become of critical importance. These issues 
demand departures from traditional comf)uler systems. 
While these departures are deemed to be desirable with 
respect to traditional computer applications, they arc essen 
tial for rapid man-machine interaction. 



System Requirements 

In the early days of computer design, there was the concept 
of a single program on which a single processor computed 
for long periods of time with almost no interac tion with the 
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The effective boundaries of an information prw essing sys- 
tem extend beyond the processor, beyond the card reader 
and printer, and even beyond the typing of input and the 
printing of output. In fact, they encompass the goals of many 
people. To better understand the effect of this broadenoci 
design scope, it is helpful to examine several phenomena 
characteristic of large, service-oriented computer installa- 
tions. 

First, there are incentives for any organization to have the 
biggest possible computer system that it can afford. It is 
usually only on the biggest computers that there arc elai)o- 
rate programming systems, compilers, and features whic h 
make a computer "powerful". This results partly bec.uise it 
is more difficult to prepare system programs for smaller com 
puters when limited by speed or memory si/e, and partly 
because large systems involve more persons and, heme, 
permit more attention to be given to system pro«rams. 
Moreover, by combining resources in a single computer 
system rather than in several, bulk economies and thcri'fore 
lower computing costs can be achieved. Finally, as a practi- 
cal matter, considerations of floor space, management efti- 
ciency, and operating personnel provide a strong inc entivc 
for centralizing computer facilities in a single large installa- 
tion. 

Second, the capacity of a contemporary comfuiler instal- 
lation, regardless of the sector of applications it sorves, must 
be capable of growing to meet continuously incrcMsing de- 
mand. A doubling of demand every two years is not uncom- 
mon, Multiple-accc^ss computers promise to accelerate this 
growth further since they allow a man-mac iiine intc>rac lion 
rate which is faster by at liMst two orders ot magnilude Ih.ui 
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other types of computing systems. Present indications are 
that multiple-access systems for only a few hundred users 
can generate a demand for computation exceeding the ca- 
pacity of the fastest existing single processor system. Since 
the speed of light, the physical sizes of computer compo- 
nents, and the speeds of memories are intrinsic limitations on 
the speed of any single processor, it is clear that systems with 
multiple processors and multiple memory units are needed 
to provide greater capacity. This is not to say that fast pro- 
cessor units are undesirable, but that extreme system com- 
plexity to enhance this single parameter among many 
appears neither wise nor economic. 

Third, computers are no longer a luxury used when and 
if available, but are primary working tools in business, gov- 
ernment, and research laboratories. The more reliable com- 
puters become, the more their availability is depended upon. 
A system structure including pools of functionally identical 
units (processors, memory modules, input/output controll- 
ers, etc.) can provide continuous service without significant 
interruption for equipment maintenance, as well as provide 
growth capability through the addition of appropriate units. 

Fourth, user programs, especially in a timesharing system, 
interact frequently with secondary storage devices and ter- 
minals. This communication traffic produces a need for mul- 
tiprogramming to avoid wasting main processor time while 
an input/output request is being completed. It is important 
to note that an individual user is ordinarily not is a position 
to do an adequate job of multiprogramming since his pro- 
gram lacks proper balance, and he probably lacks the neces- 
sary dynamic information, ingenuity, or patience. 

Finally, as noted earlier, the value of a timesharing system 
lies not only in providing, in effect, a private computer to a 
number of people simultaneously, but, above all, in the ser- 
vices that the system places at the fingertips of the users. 
Moreover, the effectiveness of a system increases as user- 
developed facilities are shared by other users. This increased 
effectiveness because of sharing is due not only to the re- 
duced demands for core and secondary memory, but also 
to the cross-fertilization of user ideas. Thus, a major goal of 
the present effort is to provide multiple access to a growing 
and potentially vast structure of shared data and shared 
program procedures. In fact, the achievement of multiple 
access to the computer processors should be viewed as but 
a necessary subgoal of this broader objective. Thus, the 
primary and st^condary memories where programs reside 
play a central role in the hardware organization, and the 
presence of independent communication paths between 
memories, processors, and terminals is of critical impor- 
tance. 

From the above it can be seen that the system require- 
ments of a computer installation are not for a single program 
on a single computer, but rather for a large system of many 
components serving a community of users. Moreover, each 
user of the system asynchronously initiates jobs of arbitrary 
and indeterminate duration which subdivide into sequences 
of processor and input /output tasks. It is out of this seem- 
ingly chaotic, random environment that one arrives at a 
utility-like view of a computing system. For instead of chaos, 
one can average over the different user requests to achieve 
high utilization of all resources. The task of multiprogram- 



required to do this need only be organized once in a central 
supervisor program. Each user thus enjoys the benefit of 
efficiency without having to average the demands of his own 
particular program. 

With the above view of computer use, where tasks start 
and stop every few milliseconds, and where the memory 
requirements of tasks grow and shrink, it is apparent that one 
of the major jobs of the supervisor program (i.e., monitor, 
executive, etc.) is the allocation and scheduling of computer 
resources. The general strategy is clear. Each user's job is 
subdivided into tasks, usually as the job proceeds, eac h of 
which is placed in an appropriate queue (i.e., for a proc essor 
or an input/output controller). Processors or input /output 
controllers are, in turn, assigned new tasks as they either 
complete or are removed from old tasks. All processor's are 
treated equivalently in an anonymous pool and are assigned 
to tasks as needed. In particular, the supervisor does not 
have a special processor. Further, processors can be .ulded 
or deleted without significant change in either the user or 
system programs. Similariy, input/output controllers are di- 
rected from queues independently of any particular f)ro- 
cessor. Again, as with the processors, one can add or delete 
input/output capacity according to system load without sig- 
nificant reprogramming required. 



The Multics System 

The over-all design goal of the Multics system is to ( reale a 
computing system which is t.jpable of tomprehensively 
meeting almost all of the [)resent and near future reciuire 
ments of a large computer service installation. It is not ex 
pected that the initial system, although useful, will r(Mc h the 
objective; rather, the system will evolve with time in a g<MV- 
eral framework which permits continual growth to nuH-t 
unknown future requirements. The use of the PI /I language 
will allow major system software changes to be developed 
on a schedule separate from that of hardware changes. Sine e 
most organizations can no longer afford to overlaf) old and 
new equipment during changes, and since software develop- 
ment is at best difficult to schedule, this relative machine- 
independence should be a major asset. 

It is expected that the Multics system will be published and 
will therefore be available for implementation on any ecjuip- 
ment with suitable characteristics. Such publication is desir- 
able for two reasons: first, the system should withstand 
public scrutiny and criticism; second, in an age of inc re.ising 
complexity, there is an obligation to present and future sys 
tem designers to make the inner operating system <»s luc id .»s 
possible so as to reveal the basic system issues. 

An ability to share data contained within the framework 
of a general-purpose timesharing system is a uni(iue fe.iture 
of Multics, and is directly applicable to administrative^ prob- 
lems, research requiring a multi-user accessible d.ilab.ise, 
and general application of the computer to very com[)li( .ited 
research problems. The <Ulefition paid to mechanisms to 
f)rovide and control privacy is of direct interest for several 
of the same .ipplic <ilions as well ,is, lor example, niediial 
data. Multics can thus be a valuable tool which pinvides 
opportunities for important new rescirch in these areas. 
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I ne nardware system 

The Honeywell 645 computer system is a large-scale infor- 
mation processing system with most of the features currently 
found in such systems. If one attempted to classify systems, 
it would fall in the same general category of size as the 
Honeywell 635, the Univac 1108, and the IBM Systems 
360/65 and 67. 

The configuration at M.I.T., shown in Figure 1, currently 
contains 384 K (K = 1024) 36-bit words of core memory (1 
microsecond access to 36 bits or 1 .3 microseconds access 



to 72 bits), two central processors (330,000 instructions per 
second when running Multics), a high-performanco paging 
drum (it moves 1024 words in 2 milliseconds, 16 mil- 
liseconds average latency with a queue-driven channel con- 
troller), 78 million words of disk storage, and a Genorali/cd 
I/O Controller which handles magnetic tapes, card equif)- 
ment, and high-speed full ASCII printers, as well as all tele 
communication channels. The central processor is built on 
the Honeywell 635 instruction set with augmentation to per 
mit control of paging and segmentation hardware. 
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Overview of Multics Capabilities 



The virtual memory approach 



Multics offers a number of capabilities which go well beyond 
those provided by many other systems. Those which are 
most significant from the user's point of view are described 
here. Perhaps the most interesting aspect of all is that a single 
system encompasses all of these capabilities simultaneously. 

■ The ability to be a small user of Multics. 

An underlying consideration throughout the Multics de- 
sign has been that the simple user should not pay a 
noticeable extra price for a system which also accommo- 
dates the sophisticated user. For example, a student can 
be handed a limited set of tools, can do limited work 
(perhaps debugging and running small FORTRAN pro- 
grams), and expect to receive a bill for resource usage 
which is equivalent to the limited work done. If all users 
are small, then of course the number of users can be 
increased in proportion to their smallness. As an adminis- 
trative aid, facilities are provided so that one can restrict 
any particular user to a specific set of tools and thereby 
limit his ability to use up resources. 

■ The ability to control sharing of information. 

There are a variety of applications for a computer system 
which involve building up a base of information which 
is to be shared among several individuals. Multics pro- 
vides facilities in two directions. 

Sharing: 

Links to other users' programs and data. , 

Ability to move one's base of operation into another user's 
directory (with his permission). 

Direit access with uniform conventions to any information 
storetJ in the system. 

Ability for two or more users to sh.uc a single copy of a 
progr.im or (iata in core memory. 

Control; 

Ability to specify f)recisely to whom, and with what access 
mode (e.g., read, write, and execute permissions are sepa- 
rate an(i per-user) a piece of data or the entire c ontents of 
a subdirectory are available, 

At)ilily to revoke access at any time. 

Ability, using the Multics protection ring structure, to force 
at cess to a database to be only via a program supplied by 
the database owner. This facility may be used to allow 
ac c ess to aggregate inform.ition, su( h .is averages or counts, 
or specified (iata entries, without simultaneously giving ac- 
i «>ss to the entire file of raw data, w!ii( h may be (onfiden- 
lial Ihere are a large iuiinl)er ul potential ailministrative 
.i()plKalions of this lealuri>, and as la? as is known, Multics 
IS the only genera I -purpose system which provides it. 



In the opposite direction of the little user is the person 
with a difficult research problem requiring a very largo 
addressable memory. The Multics storage system, with 
the aid of a high-performance paging drum, provides this 
facility in what is often called a virtual memory of an 
extent limited only by the total of secondary storage 
devices (drums, disks, etc.) attached to the system. An 
interesting property of the Multics implementation is thai 
a procedure may be written to operate in a very large 
virtual memory, but core resources are used only for 
those parts of the virtual memory actually touched by the 
program on that execution, and disk and drum resources 
are used only for those parts of the memory which ac tu- 
ally contain data. Another very useful property from a 
programmer's point of view is that information storcci in 
the storage system is directly accessible to his f)r()gram 
by a virtual memory address. This property eliminaK^s 
the need for explic itiy [jrogrammed overlays, ( hain links, 
or core loads, Mui also reduces the number of cxplii itly 
programmcKJ input and ou{[)Ut operations. The Miilli(s 
storage system takes on the responsibility for s.ifck(H'[)ing 
of all information placcxf there by th(^ user. It ihert'iore 
automatically maintains tape copies of all inforni.ition 
which has remained in the system for more than an hour. 
These tapes can be used to reload any user information 
lost or damaged as a result of hardware or software 
failures, and may also be used to retrieve individual items 
damaged by a user's own blunder. 

Each user has an administratively set quota of sp.uc 
which limits the amount of storage he can use, although 
he may purchase as large an amount of spac e as he 
would like. Additional disk storage can be addend to the 
645 computer in large quantities if necessary. 

The option of dynamic linking. 

In constructing a [)rogram or system of ()r()gr.»nis, il is 
frequently convenic^nt to begin testing c crttiin teaUircs ot 
onc> program before fiaving writlcn anolhcr pi()>;iain 
whic h is n(H>ded for somk^ c ases. I )vnamii linking allows 
the exec ulion of the first progriUn lo begin, .tnd a scire h 
for the second f)rogram is undertaken only if .md when 
it is actually called by the first one. I his feature .iKo 
allows a user to freely include in his proKr.un a tondi 
tional call out Icj a large and sof)histicale{l error diagnos- 
tic program, secure in the knowlecJge that in all those 
executions of his prograrri which do not encounter the 
error, he will not pay the cost of locating, linking, .ind 
mapping the error diagnosis package into his virtu.il 
memory. It also allcjws a user who is borrowing a f)r()- 
gram to provide a substitute for any subroutine c .illed by 
that program when he uses il, since he h.is control over 
where the system looks to find missing sul)r()utines. In 
those cases where subroutine A calls subroutine H every 
time, there is, of course, no nee(i to use dynamic linking 
(atid the itiiplied library search), and so facilities aie 
therefore providecl to bind A ancf B logelhei |)rioi lo 
execution. 
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■ Configuration Flexibility. 

An important aspect of the Multics design is that it is 
actually difficult for a user to write a program which will 
stop working correctly if the hardware configuration is 
changed. In response to changing system-wide needs, 
the amount of core memory, the number of central pro- 
cessors, the amount and nature of secondary storage 
(disks, drums, etc.), and the type of interactive typewriter 
terminals may change with time over a range of 2 or 3 
to 1, but users do not normally need to change their 
programs to keep up with the hardware. The system itself 
adapts to changes in the number of processor or memory 
boxes dynamically, that is, while users are logged in. 
Most other configuration changes (e.g., the addition of 
disk storage units) require that the system be reinitialized, 
an operation which takes a few minutes. 

■ The human interface. 

Experience has proven that ease of use of a timesharing 
system is considerably more sensitive to human engi- 
neering than is a batch processing system. The Multics 
command language has been designed with this in mind. 
Features such as universal use of a character set with 
both upper and lower case letters in it, and allowing 
names of files to be 32 characters long, are examples of 
the little things which allow the nonspecialist to feel that 
he does not have to discover a secret in order to be an 
effective user of the system. In a similar vein, a hierar- 
chial file system provides a very useful organization and 
bookkeeping aid, so that a user need keep immediately 
at hand only those things he is working with at the mo- 
ment. Such a facility is of great assistance when attacking 
complicated or intricately structured problems. 



Languages 

Multics provides two primary user languages: FORTRAN IV 
and PL/ 1. The FORTRAN compiler is fairly standard. It is 
supported by the usual library of math routines and format- 
ted input /output facilities. Its primary use is for translation of 
already written programs which have been imported from 
other computer systems. 

The Multics PL /I compiler is quite interesting because it 
offers a very full selection of language facilities, over 300 
helpful error diagnostics, and the ability to get at the ad- 
vanced features of Multics, all at a reasonable cost. On a 
"seconds to translate a source language page" basis, the 
PL/I compiler currently takes about twice as long as does the 
FORTRAN compiler; on the other hand, a page of PL/ 1 
program can express considerably more than a page of FOR- 
TRAN program. For these reasons, as well as the anticipated 
wide availability of PL/I on other computer systems, it is the 
recommended language tor suhsyslern nnpicfTienlers .ind 
KtMier.il rese.ireh userv needinf.; .«n ex!)re^Mve Jonmi.ige. 

( )l!iei l.ingu.im's .ue: 



BASIC A translator and editor subsystem for the BASIC 
language, developed at Dartmouth College. A lim- 
ited Multics service is available which restricts the 
use^ to just this subsystem, if desired. The BASIC 
subsystem is also available to regular Multics users. 

APL A powerful and popular interpretive language devel- 
oped by Kenneth Iverson. 

LISP List Processing language, version 1 .5. Both an inter- 
preter and a compiler for this popular language for 
"artificial intelligence" problems are available. An 
interesting feature of the Multics implementation is 
the very large structure space provided by the vir- 
tual memory. 

ALM A machine language assembler for the Honeywell 
645 computer. (It is not recommended for general 
use; it is slow and the language is very difficult.) 

QEDX A programmable editor which qualifies as a minor 
interpretive language. 

All of the above languages translate a source program whic h 
has been previously placed in the storage system. In()u! i\n(.\ 
editing of source text is done with one of the avail.ible text 
editors, EDM or (}EDX. Although interactive, line-l)y-line 
syntax checking languages are easily implemented in th(> 
Multics environment, none are yet available. 

A source language debugging system, named DEBUC, 
provides the ability to inspect variables and set breakpoints 
in terms of the PL/ 1 program being debugged. It also has a 
variety of features to allow inspection of all aspects of the 
Multics execution environment. 



Reliability and Performance 

An initial version of Multics began operating on a sc hedultnl 
daily basis for system programming use in I9(>8 Sc^ptember. 
It has been scheduled to run on a 24-hc)ur-a-ciay l)asis sine e 
1969 May 1. Since that time, almost thrcv years ol oper.i 
tional experience has been obtained During this time, reli- 
ability, functional c apabilities, and performance h.w(> been 
brought to the point that, as of 1972 January 1, a two pro- 
cessor system serves ."i.S simultaneous users, with good in- 
teractive response. 

The full configuration of Figure 1 is usc^d rc^gularly, and 
should ultimately handle about 90 average PL /I program- 
mers. Both smaller and larger users are also runnable on the 
system, in increased and reduced numbers, respectively. 

As an offering of the M.I.T. Information Processing Cenlc»r, 
Multics has attracted a community of about 600 registered 
users, and an equal number of unregistered student users. 
These users are organized around approximately 100 
projects, thus making Multics the primary source of time- 
sharing services at M.LT. (As with all I.P.C. computer svs- 
lems, the use of Mulli( s is (barged to its iiseis .il i.iles 
adjusted to return full hardware .md Minnmg ( osis when the 
system is operalinK al about two-lhirds capacilv 1 
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A MULTICS BiBLiOGRAPHY 



Manuals that are Generally Available 

1. Multics Programmers' Manual. An updateable refer- 
ence manual giving calling sequences and reference 
information for all user-callable subroutines and com- 
mands. Includes an introduction to the Multics pro- 
gramming environment and a guide to typical ways of 
using the system. Approximately 800 pages. 

2. The Multics System: An Examination of Its Structure, 
by E. I. Organick. A hard cover book describing in some 
detail how Multics works. The description is from the 
point of view of a programmer developing a large pro- 
gram or subsystem, who wishes to gain the extra insight 
to help him intelligently choose among available alter- 
natives of his implementation. M.I.T. Press, Cambridge, 
MA, and London, England. 392 pp. (1972). 



3. 



6. 



A User's Guide to the Multics FORTRAN Implementa- 
tion, by R.A. Freiburghouse. A document which pro- 
vides the prospective Multics FORTRAN user with 
sufficient information to enable him to create and exe- 
cute FORTRAN programs on Multics. It contains a com- 
plete definition of the Multics FORTRAN language as 
well as a description of the FORTRAN command and 
error messages. It also describes how to communicate 
with non-FORTRAN programs, and discusses some of 
the fundamental characteristics of Multics which affect 
the FORTRAN user. 68 pages. 

Multics PL/ 1 language Specification. A reference man- 
ual which specifies precisely the subset of the PL/ 1 lan- 
guage used on Multics. 1 74 pages. 

User's Guide to the Multics PL/I Implementation, by 
R.A Freiburghouse, et al. Provides detailed information 
about how the PL/I language is embedded in the Mul- 
tics programming environment. 53 pages. 

Graphic Users' Supplement to the Multics Program- 
mers' Manual In the same format as the Multics Pro- 
grammers' Manual, this supplement gathers in one 
plaic (li>s(fipti()Ms of Iho Multics Craphits System and 
Ihf commands and subroutines needed to use it. Ap- 
proxini.ac'ly SS pages, illustrated. 



Manuals that may be examined in the 
Project MAC or I. P. C. Document Rooms 

1. Multics System Programmers' Manual In ()rinc i[)le, a 
compk^te rt^ference manual describing how th(> system 
works inside. In fact, this doc ument contains m.uiy sec - 
tions which are inconsistent, inaccurate, or obsolete'; it 
is in need of much upgrading. FHowever, its overview 
sections are generally accurate and valuable if insight 
into the internal organization is desired. Approximately 
3,500 pages. 

2 . System Programmers ' Supplement to the Multic s Pro- 
grammers' Marwal This updatcMble reference manu.il, 
in the same format as the Multics Programmers' Man- 
ual, provides calling sequencer of t*very system 
module. Approximately 850 pages. 

3. EPLBSA Programmer's Reference Handbook, by 
D.j.Riesenberg. A manual describing the asseml)ly (ma- 
chine) language for the Honeywell (345 c ()m[)uler. The 
language has been renamed ALM since the public alion 
of this manual. (Needt^d only by progr.jmmers with 
some special rcMson to use (>45 tnachinc language.) BS 
pages. 

4. Honeywell 645 Processor Manual. A hardware- de- 
scription, including ofKodes, addressing modifiers, v\c. 
Of interest only to dedicated machine* language pro- 
grammers. I 75 pages. 



5. 



Subsystem Writers' Supplement to (he Multns Pro- 
grammers' Manual. A manual giving c ailing seMiucne es 
of internal interfaces of the system whic h are user- 
accessible. For the sophistic atecl subsystem wrile>r who 
feels thai it is important to bypass some standard Mul- 
tics facility, this manual provides some help in using 
interfaces one level deeper into the system. This manual 
is definitely not for the casual user. Approximately 50 
pages. 
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Technical Papers about Multics 

1. F.J.Corbatb and V.A.Vyssotsky, "Introduction and Overview 
of the Multics System", AFIPS Conf. Proc, Fall joint Comput. 
Conf. 27, Spartan Books, Washington, DC, 1965, pp. 185- 
196. 

2. E.L.GIaser, et al., "System Design of a Computer for Timeshar- 
ing Application", AFIPS Conf. Proc, Fall joint Comput. Conf. 
27, Spartan Books, Washington, DC, 1965, pp. 197-202. 

3. V.A.Vyssotski, et al., "Structure of the Multics Supervisor", 
AFIPS Conf Proc., Fall joint Comput. Conf 27, Spartan 
Books, Washington, DC, 1965, 203-212. 

4. R.C.Daley and P.C.Newmann, "A General-Purpose File Sys- 
tem for Secondary Storage", AFIPS Conf Proc., Fall joint 
Comput. Conf 27, Spartan Books, Washington, DC, 1965, 
pp. 213-229. 

5. j.F.Ossanna, et al., "Communication and Input/Output 
Switching in a Multiplex Computing System", AFIPS Conf. 
Proc., Fall joint Comput. Conf 27, Spartan Books, Washing- 
ton, DC, 1965, pp. 231-241. 

6. E.E.David, Jr. and R.M.Fano, "Some Thoughts About the Social 
Implications of Accessible Computing", AFIPS Conf Proc., 
Fall joint Comput. Conf 27, Spartan Books, Washington, DC, 
1965, pp. 243-247. 



17. I.M.Grochow, "Real-Time Graphic Display of Timesharing 
System Operating Characteristics", AFIPS Conf Proc . Fall 
joint Comput. Conf 35, AFIPS Pr., 379-385 (1969). 

18. j.H.Saltzer and j.F.Ossanna, "Remote Terminal Character 
Stream Processing in Multics", AFIPS Conf. Proc, Spring joint 
Comput. Conf 36, AFIPS Pr., 621-627 (1970). 

19. J.F.Ossanna and J.H.Saltzer, "Technical and Human Engineer- 
ing Problems in Connecting Terminals to a Timesharing Sys- 
tem", AFIPS Conf Proc., Fall joint Comput. Conf 37, AFIPS 
Pr., 355-362 (1970). 

20. D.D.Clark, R.M.Graham, j.H.Saltzer and M.D.Schroeder, 
"Classroom Information and Computing Service", M.I.T. 
Project MAC Technical Report TR-80, (1971). 

21. M.D.Schroeder, "Performance of the CE-645 Associative 
Memory While Multics is in Operation", ACM Workshop on 
Syst. Performance Evaluation, 227-245 (1971). 

22. M.D.Schroeder and J.H.Saltzer, "A Hardware ArthiUH^^turo for 
Implementing Protection Rings", ACM Third Symp. on Oper- 
ating Syst. Principles, Palo Alto, CA, (1971). 

23. R.J.Reiertag and E.I.Organick, "The Multics Input/Output Sys- 
tem", ACM Third Symp. on Operating Syst. Principles. Palo 
Alto, CA, (1971). 



7. A.Bensoussan, CT.CIingen and R.C.Daley, "The Multics Vir- 
tual Memory", ACM Second Symp. on Operating Syst. Princi- 
ples, Princeton University, 30-42 (1969). 

8. CT.CIingen, "Program Naming Problems in a Shared Tree- 
Structured Hierarchy", NATOSci. Committee Con f on Tech- 
niques in Software Engg. 1, Rome, Italy (1969). 

9. R.M.Graham, "Protection in an Information Processing Util- 
ity", Commun. ACM 11, No. 5, 306-312 (1968). 

1 0. F.j.Corbato and J.H.Saltzer, "Some Considerations of Supervi- 
sor Program Design for Multiplexed Computer Systems", IFIP 
Conf Proc.. Invited Papers, 66-72 (1968). 

1 1 . R.C.Daley and J.B.Dennis, "Virtual Memory, Processors, and 
Sharing in MULTICS", Commun. ACM 11, No. 5, 365-369 
(1968). 

12. F.J.Corbatd, "PL/I as a Tool for System Programming", Data- 
mation 15, No. 6, 68-76 (1969). 

1 3. F.J.Corbatb, "A Paging Experiment with the Multics System", 
In Honor of PM. Morse, M.I.T. Pr., Cambridge, MA, 21 7-228 
(1969). 

1 4. J.H.Saltzer and J.W.Gintell, "The Instrumentation of Multics", 
ACM Second Symp. on Operating Syst. Principles, Princeton 
University, 167-174 (1969), also in Commun. ACM 13, No. 
8,495-500(1970). 

15. M.J. Spier and E.I.Organick, "The Multics Inter-Process Com- 
munication Facility", ACM Second Symp. on Operating Syst. 
Principles. Princeton University, 83-91 (1969). 



M.I.T. Theses related to Multics 

1. J.H.Saltzer, "Traffic Control in a Multiplexed Computer Sys- 
tem", Sc.D., MAC-TR-30, (1966). 

2. R.Rappaporl, "Implementing Multi-Process Primitives in ,i 
Multiplexed Computer System", S.M., MAC-TR-55, (1968). 

3. H.Deitel, "Absentee Computations in ,i Mul^iple-A(.^^'s^ ( oin- 
puter System", S.M., MAC-TR-52, (1968). 

4. j.Greenbaum, "A Simulator of Multiple Interactive Users to 
Drive a Timeshared Computer System", S M., MAC -TK-SH, 
(1968). 

5. I.M.Grochow, "The Graphic Display as an Aid in lh«' Monitor- 
ing of a Timeshared Computer System", S.M., MAC-rR-54, 
(1968). 

6. R.I.Ancona, "A Compiler for MAD-Based Language on Mul- 
tics", S.M., (1968). 

7. D.Clark, "A Reduction Analysis System for Parsing PL /I", 
S.M., (1968). 

8. M.D.Schroeder, "Classroom Model of an Information and 
Computing Service", S.M., (1969). 

9. C.M.Vogt, "Susjwnsion of Processes' in a MultiprtKossing 
Computer System", S.M., (1970). 

10. R.Frankston, "A Limited Service System on Mullirs", S.H.. 
(1970). 



16. R.A.Freiburghouse, "The Multics PL/I Compiler", AFIPS Conf 
Proc. 35, AFIPS Pr., 187-199 (1969), 



1 1 . R.R.Schell, "Dynamic Reconfiguration in a Modular Compiilei 
System", Ph.D., (1971). 
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D-ii 



FO 



LEVEL 68 CURRICULUM 
HONEYWELL MARKETING EDUCATION 



General 




F01 


5-Days 


F02 


1-Day 


Languages 




Gil 


3-Days 


+F11 


2-Days 


+F12 


2-Days 


F13 


5-Days 


F14 


3-Days 


F15 


5-Days 


F15C 


3-Days 


F15D 


5-Days 


F19 


2-Days 


Data Base 




F32 


3-Days 


F31 


5-Days 


F30 


2-Days 


Word Proces 


sing 


»F41 


1-Day 


*F42 


3-Days 


F43 


5-Days 



Multics Concepts and Utilization 
Multics Features, Functions, and 
Benefits 



APL 

APL Specifics 

BASIC Specifics 

COBOL-74 Specifics 

FORTRAN Specifics 

Multics PL/I Programming 

Advanced PL/I Programming 

Application Subsystem Programming 

Techniques 
Advanced Program Debugging Techniques 



LINUS Utilization 
MRDS Utilization 
MRPG Utilization 



WORDPRO Basic Utilization 
WORDPRO Advanced Utilization 
WORDPRO for Document Administrators 



Administration and Operation 
F60 5-Days 
F617 6-8 Hour VAL 
F68 5-Days 

Applications 

+F70 5-Days 

Operating Supervisor 
F80 5-Days 
+F81 5-Days 
+F86 5-Days 

Miscellaneous 

+F90 3-Days 



System Administration 
Project Administration 
Operator Training 



Graphics Programming 



Multics Process Management Analysis. 
Multics Failure Analysis and Recovery 
MCS Concepts and Implementation 



GCOS Environment Simulator 
Utilization 



Not currently available (December, 78) 
Conducted on-site by special request only 

D-1 



F01 



LANGUAGES 



RECOMMENDED 



COURSE SELECTION GUIDE 

SUPPLEMENTAL/OPTIONAL 



MULTICS CONCEPTS AND UTILIZATION 



I MULI 
I FOl 



1 



CLASSROOM 




5-DAYS 



PL /I CONCEPTS 



G15 



CLASSROOM 



i 



2-DAYS 



COMMERCIAL PL /I PROGRAMMING 



F15A 



CLASSROOM 



3-DAYS 



F15B 



SCIENTIFIC PL/ I PROGRAMMING 

~~1 3-DAYS 



CLASSROOM 



ADVANCED PROG RAM DEBUGGING TECH. 

I 2-DAYS 



F19 



CLASSROOM 



I 



ADVANCED PL/ I PROGRAMMING 


F15C CLASSROOM 3-DAYS 


1 


r 


APPLICATION SUBSYSTEM PROG. 


T?lRTll CLASSROOM 1 5-DAYS 




COBOL PROGRAMMING 



G434 



SI 



30-36 HRS 



COBOL- 74 PROGRAMMING SPECIFICS 



F13 



CLASSROOM 



5-DAYS 



ADVANCED PROGRAM DEBUGGING 
FI9 I CLASSROOM I ! 



TECH. 1 
>-DAYS I 




FORTRAN IV LANGUAGE 



G047 



VAL 



30-34 HRS 



FORTRAN 



SPECIFICS 



F14 



m ACCPOOM 



3-DAYS 



FUNDAMENTALS OF EDP 



G014 



SI 



6-8 URS 



PT?nr,RAMMTNG LOGIC & FLOWCHARTING 


G024 


SI 136-44 HRS 




DECISION TABLES ^ 


G527 


VAL 112-16 HRS 





MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



6-8 HRS 



COBOL CONCEPTS 



G334 



SI 



12-15 HRS 




BASIC (PROGRAMMING LANGUAGE) 



G537 I 



VAL 



I 



J^GUAGE) 1 
12-16 HR S I 



BASIC SPECIFICS 



F127 I 



VAL 



ri2-16 HRS 



^ 



Gil 



APL (PROGRAMMING LANC UAGlQ 

CLASSROOM I Jb'M.^- 



Fll 



APL SPECIFICS 

^CLAS SR00M_jL_„_2z] 1^1?- 
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DATA BASE 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL /OPT TONAL 



MULTICS CO NCEPTS & UTILIZATION 

5-DAYS 



FOl 



CLASSROOM 



C^K^ 



zi_ 



LINUS & REPORT GEN. UTILIZATION 

I 5-DAYS 



F32 



CLASSROOM 



COMMERCIAL PL /I PROGRAMMING 
F15A I CLASSROOM I 3-DAYS" 



COBOL- 74 SPECIFICS 



F13 



CLASSROOM 



I 



5-DAYS 



MRDS UTILIZATION WITHIN 
APPLIC. PROG. 



F31 



CLASSROOM 



5-DAYS 



FUNDAMENTALS OF EDP 



G014 I CLASSROOM 1 6-8 11 US 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



I 6-8 HRS 



DATA BASE CONCEPTS 



G078 



IBR 



1-HR 



ADMINISTRATION AND OPERATION 
COURSE SELECTION GUIDE 



RECOMMENDED 




MULTICS CONCEPTS & UTILIZATION 
FOl I CLASSROOM 1 5-DAYS 



PROJECT ADMINISTRATION 



F6i7r 



VAL 



4-6 HRS 



SYSTEM ADMINISTRATION 
F60 I C LASSROOM i 5-DAYS 




SUPPLEMENTAL /OPTIONAL 



FUNDAMENTALS OF EDP 



G014 



SI 



6-8 HRS 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 
F027 I VAL 16-8 HRS" 



n-4 



OPERATING SUPERVISOR 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL /OPTIONAL 



MULTICS CONCEPTS & UTILIZATION 



FOl 



CLASSROOM 



5 -DAYS 



PL/ I CONCEPTS 



G15 



CLASSROOM 



2-DAY S 



COMMERCIAL PL/ 1 PROGRAMMING 



F15A 



CLASSROOM 



I 



3-DAYS 



SCIENTIFIC PL /I PROGRAMMING 



F15B 



CLASSROOM 



I 



3-DAYS 



ADVANCED PROGRAM DEBUGGING TECH. 



F19 



CLASSROOM 



2-DAYS 





FUNDAMENTALS 


OF EDP 




G014 


SI 


6-8 


HRS 




PROGRAMMING LOGIC 


& FLOWCHARTINC; 


G024 


SI 


! 36-44 


HRS 






DECISION 


TABLES 




G527 


VAL 


12-16 


HRS 




MULTICS FEATURES, 

FUNCTIONS & BENEFITS 




F027 


VAL 


6-8 


HRS 



ADVANCED PL /I PROG. TECHNIQUES 



F15C 



CLASSROOM 



I 



3-DAYS 



APPLICATION SUBSYSTEM PROG. TECH, 



F15D 



CLASSROOM 



5-DAYS 



SYSTEM ADMINISTRATION 



F60 



CLASSROOM 



5-DAYS 



MULTICS PROCESS MGMT. ANALYSIS 



F80 



CLASSROOM 



5-DAYS 



i 



OPERATOR TRAINING 



F68 



CLASSROOM 



5-DAYS 



MULTICS FAILURE ANALYSIS & RECOV. 



F81 



CLASSROOM 



5-DAYS 



COMMUNICATIONS 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL /OPTIONAL 



FOl i CLASSROOM 



5-DAYS 



I 



COMMUNICATION CONCEPTS 



G60 



CLASSROOM 



2-DAYS 



I 



MCS CONCEPTS & IMPLEMENTATION 



F86 



CLASSROOM 



5-DAYS 



FUNDAMENTALS OF EDP 



G014 



SI 



6-8 HRS 



COMMUNICATIONS CONCEPTS (BASIC) 
G064 I SI ~~ 



I 6-8 HRS 



COMM. SYS. ANALYSIS & DESIGN 



G86 



CLASSROOM 



5-DAYS 



i nriTTW rixCTTtT-DTTT-CT* l?\nTT OnMMTTMT I 



|xiix:i UJ. O xts-i-iju xiMj m.1 * ■t.i.wi.iti.j-it. J. I 
G80 I CLASSROOM j 2-DA ^J 



MULTICS FEATURES, FUNCTIONS, 

& BENEFITS 

F027 I VAL I 6-8 HRS 



D-6 



APPLICATIONS AND MISCELLANEOUS 
COURSE SELECTION GUIDE 



RECOMMENDED 



SUPPLEMENTAL/OPTIONAL 



MULTICS CONCEPTS & UTILIZATION 



FOl 



CLASSROOM 




5-DAYS 



GRAPHICS PROGRAMMING 



F70 



CLASSROOM 



3-DAYS 




GCOS ENVIRONMENT SIMULATOR UTIL. 



F90 



CLASSROOM 



3-DAYS 



MULTICS FEATURES, 

FUNCTIONS & BENEFITS 



F027 



VAL 



6-8 HRS 



n-7 
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COMMANDS/MANUALS CROSS REFERENCE 



AG92/r2 029and963 

AG92/r2 MAP 

AR97/aA TEST (BOS) 

AR97/aA TSTCHN (BOS) 

AK92/aB aa 

AG92/r2 ab 

AG92/r2 abbrev 

AZ03/rO abbrev_ 

AZ03/rO abbrev_$abbrev_ 

AZ03/rO abbrev_$expanded_line 

AZ03/rO abbrev_$set_cp_ 

AG92/r2 abc ^ 

AG93/aD absolute_pathnaine_ 

AG92/r2 ac 

AG92/r2 accept_messages 

AN52/rO acm 

AK92/aB active_fnc_err_ 

AS68/rO add_anon 

AG92/r2 add_name 

AG92/r2 add_search_rules 

AG92/r2 ad just_bit_count 

AG93/aD ad just_bit_count_ 

AK50/rO admin_util 

AK92/aB aim_check_ 

AK92/aB aim_check_$equal 

AK92/aB aim_check_$greater 

AK92/aB aim_check_$ 

greater_or_equal 

AN52/rO alarm_clock_meters 

AK92/aB aim 

AK92/aB alm_abs 

AG92/r2 alv 

AG92/r2 am 

AG92/r2 an 

AG92/r2 and (AF) 

AG92/r2 ans 

AG92/r2 answer 

AG92/r2 apl 

AG92/r2 ar 

AG92/r2 archive 

AK92/aB archive_sort 

AK92/aB area_info_ 

AK92/aB area_status 

AK92/aB as 

AK51/r1 as_who 

AK92/aB ascii_to_ebcdic_ 

AK92/aB ascii_to_ebcdic_$table 

AZ03/rO ask_ 

AZ03/rO ask $ask 



AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AZ03/rO 
AG92/r2 
AK92/aB 
AG92/r2 
AG92/r2 
AG92/.r2 
AG92/r2 
AS68/rO 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AS68/rO 
AS68/rO 
AS68/rO 
flG92/r2 
AG92/r2 
AZ03/rO 
AN52/rO 
AG92/r2 
AG93/aD 
AS68/rO 
AK50/rO 
AS68/rO 
AK50/rO 
AG92/r2 



ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask 

ask_$ask_ 

ask_$ask_ 

ask_$ask_ 

ask_$ask_ 

asr 

assign_ 

assign_re 

attach_lv 

basic 

bd 

bill 

bind 

branches 

calc 

cancel_ab 

cancel_co 

cancel_da 

car 

ccp 

cd 

cdr 

cdwd 

ceil (AF 

cem 

cf 

chaddr 

chalias 

change 

oHancTfO d^i 

change_er 

change_ks 

change_tu 

change_wd 

change_wd 

charge 

charge_di 

chdf_proj 

check_dir 

check iac 



c 

cflo 

cint 

cline 

clr 

flo 

int 

line 

n 

nflo 

nint 

nline 

prompt 

set line 



source 



(AF) 

s_request 
bol_program 
emon request 



fault wd i r 

ror_mode 

t_attributes 

ning parameters 

ir 

ir_ 

sk 
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*"■ 



AG92/r2 


check_info segs 


AG93/aD 


convert_authorizat ion $ 


AS68/rO 


check log 




minimum 


A.Z03/rO 


check_mdcs 


AG93/aD 


convert authorization $ 


kKbO/rO 


check mst 




to_string 


AZ03/rO 


check mst 


AG93/aD 


convert_authorization $ 


AN53/rU 


check sst 




to string short 


AK92/aB 


check_star_name 


AG93/aD 


convert date to binary 


AK92/aB 


check_star_name $entry 


AG93/aD 


convert date to binary' 


AK92/aB 


check_star_name $path 




__ 


AS68/rO 


chname 




relative 


AS68/rO 


chpass 


AK92/aB 


convert_dial message 


AS68/rO 


chprog 


AK92/aB 


convert status code 


AG92/r2 


cis 


AG92/r2 


copy 


AZ03/rO 


cka 


AG92/r2 


copy acl 


AK50/rO 


ckm 


AK50/rO 


copy as meters 


AZ03/rO 


ckm 


AG92/r2 


copy cards 


AK50/rO 


clean_card pool 


AN53/rO 


copy dump 


AK50/rO 


clear_projfile 


AN53/rO 


copy_dump$set fdump num 


AK50/rO 


clear recjfile 


A MCO /v,n 


copy_dump$sfdn 






n.i^ ^ _) / 1 \j 


AG93/aD 


clock 


AN53/rO 


copy dump seg 


AG92/r2 


close file 


AG92/r2 


copy_file 


AG92/r2 


CO 


AG92/r2 


copy iacl dir 


AK50/rO 


cob 


AG92/r2 


copy_iacl seg 


AZ03/rO 


cob 


AZ03/rO 


copy mst 


AG92/r2 


cobol 


AK92/aB 


copy_names 


AG93/aD 


com err 


AN53/rO 


copy_out 


AG93/aD 


com_e rr_ 


AK50/rO 


copy pnt 


AG93/aD 


com_err_$suppress name 


AN53/rO 


copy salvager output 


AG93/aD 


command query 


AG92/r2 


cp 


AK'30/rO 


comp_dir_info 


AG92/r2 


cpa 


AZ03/rO 


comp_dir_info 


AG92/r2 


cpf 


AG92/r2 


compare 


AZ03/rO 


cpm 


AG92/r2 


compare ascii 


AG92/r2 


cpt 


AK50/rO 


compare_mst 


AG93/aD 


cpu_time and paging 


AZ03/rO 


compare mst 


AG92/r2 


cr 


AK50/rO 


compare object 


AG92/r2 


create 


AZ03/rO 


compare_object 


AK92/aB 


create area 


AKt)0/rO 


compute_bill 


AK50/rO 


create cmf 


AK92/aB 


condition interpreter 


AK50/rO 


create daemon queues 


AG92/r2 


console_output 


AG92/r2 


create dir 


AK92/aB 


continue_to_signal 


AZ03/rO 


create ips mask 


AK92/aB 


convert_aim attributes 


AS68/rO 


credit 


AG93/aD 


convert_authorization ~ 


AK50/rO 


cref 


AG93/aD 


eonvert_authorization $ 


AZ03/rO 


cref 




decode 


AK50/rO 


cross reference 


AG93/aD 
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AK92/aB decode_descriptor 

AG92/r2 default (AF) 

AG92/r2 def er_messages 
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AS68/rO dpmf 

AG92/r2 dpn 

AG92/r2 dprint 

AK92/aB dprint_ 

AS68/rO dproj 

AG92/r2 dpunch 

AN'^2/rO dq 

AG92/r2 ds 

AK'j»0/rO dsp 

AG92/r2 dsr 

AK50/rO dump_cdt 

iiRQ7/aA HumD firmware 



AR97/aA dump_mpc 

AN53/rO dump_pdmap 

AG92/r2 dump_segment 

AN52/rO dvm 

AG92/r2 e 

AG92/r2 ear 

Avoo/oR ebcdic to ascii 

AK92/aB ebcdic~to~ascii~$table 

AG92/r2 ec 

AK50/rO ed_installation_parms 

AK50/rO ed_mgt 
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AG93/aD hcs_$terminate_seg 
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AG93/aD hcs $truncate seg 
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AK50/rO hp_set_acl 

AK50/rO hpda 
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AN71/r1 hphcs_$add_main 
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rti'« f I / f I ripri(j5_;j) 
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AK50/rO hpsa 
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AK50/rO hpsrb 

AZ03/rO hunt 
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AG92/r2 im 
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AG92/r2 in 
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AG92/r2 indent 

AG92/r2 index (AF) 

AG92/r2 index_set (AF) 

AG92/r2 initiate 
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AK51/r1 install 
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AN52/rO interrupt_meter s 
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AG92/r2 io_call 
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AK92/aB 


iox_$err_not_closed 


AZ03/rO 
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AK92/aB 
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delete_index ~ 
message_segment_$ 

get_message_count file 
message_segment $ 

get_message_ 
count_index 
message_segment $ 

get_mode_file~ 
messagesegment $ 

get_mode_index 
message_segment_$ 

incremental file index 



:-8 



FOj 



COMMANDS/MANUALS CROSS-REFERENCE 



AN69/rO 


message_segment $ 




incremental read index 


AN69/rO 


message segment $ 




ms acl add 


AN69/ro 


message_segment $ 




ras_acl_delete 


AN69/rO 


message segment_$ 




ms_acT_list 


AN69/rO 


message_segment $ 




ms_acl_replace 


AN69/rQ 


message_segment $ 




open 


AN69/rO 


message_segment_$ 




own_incremental 




read_file 


AN69/rO 


message_segment $ 




own_incremental 




read_index 


AN69/rO 


message segment $ 




own_read_file 


AN69/rO 


message_segment $ 




own_read index 


AN69/rO 


message_segment $ 




read_delete_file 


AN69/rO 


message segment $ 




read_delete_index 


AN69/rO 


message_segment_$ 




read_file 


AN69/rO 


message_segment_$ 




read_index 


AN69/rO 


message_segment $ 




update_message_file 


AN69/rO 


message_segment_$ 




update_message index 


AN52/rO 


meter_fim 


AN52/rO 


meter_gate 


AN52/rO 


meter_gate 


AN52/rO 


meter_signal 


AN52/rO 


meter util 


AN52/rO 


mg 


AG92/r2 


min (AF) 


AG92/r2 


minus (AF) 


AG92/r2 


minute (AF) 


AS68/rO 


misc 


AG92/r2 


ml 


AG92/r2 


mod (AF) 


AG92/r2 


month (AF) 


AG92/r2 


month name (AF) 



AG92/r2 

AK51/r1 

AK92/aB 

AG92/r2 

AG92/r2 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

^K50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AN69/rO 

AN69/rG 

AK50/rO 

AN69/rO 

^K50/r0 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AK50/rO 

AN69/rO 

AN69/rO 

AN69/rO 

AN69/rO 

AN69/rO 

A.N69/rQ 

AN69/rO 

AN69/rO 

AN69/rO 

AN69/rO 

AK92/aB 

AK92/aB 

AK92/aB 

AK92/aB 

AK92/aB 



move 


move dir quota 


move names 


move_quota 


mq 


ms_add name 


ms_add name 


ms create 


ms create 


ms_delete 


ms_delete 


ms_delete acl 


ms_delete_acl 


ms_delete name 


ms_delete name 


ms list acl 


ms_list acl 


ms_rename 


ms_rename 


ms_salv_util vN 


ms_salvager vN 


ms_set acl 


ms_set acl 


ms_set_max length 


msan 


msan 


mscr 


mscr 


msda 


msda 


msdl 


msdl 


msdn 


msdn 


mseg 


mseg access 


mseg_add ~ 


mseg convert 


mseg data 



mseg_index _ 
mseg_own_ 
mseg_util_ 
mseg_util_vN_ 
msf_manager_~ 
msf_manager~$acl add 
msf_manager_$acl^delete 
msf_manager_$acl list 
msf_manager $ 
acl replace 
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AK92/aB 


msf manager $adjust 


AG92/r2 


old fortran 


AK92/aB 


msf_manager_$ close 


AN53/rO 


online 355 dump_ 


AK92/aB 


msf manager $get ptr 


AN53/rO 


online dump 


AK92/aB 


msf manager $open 


AN53/rO 


online dump 355 


AK50/rO 


msla 


AG92/r2 


or (AF) 


AN69/rO 


msla 


AG92/r2 


pa 


AK50/rO 


^ 


ft M C O / -. A 


•^ *-« /^ •% wvi iiT +-^ T r^ \9 r>.'\ rrt *~w 4 f\y^ C" 


mo I li 


t\v'^ j(- / I \j 


JL^a^c: mu i o X X c: V c: -L iii^u<..i o 


AN69/rO 


msrn 


AG92/r2 


page_traGe 


AK50/rO 


mssa 


AG92/r2 


pan 


AN69/rO 


mssa 


AZ03/rO 


parse file 


AK50/rO 


mssml 


AZ03/rO 


parse file $ 


AN69/rO 


msu_ 




pa^^se file 


AG92/r2 


nequal (AF) 


AZ03/rO 


parse file $ 


AG92/r2 


new fortran 




parse file cur line 


AG92/r2 


new proc 


AZ03/rO 


parse file_$ 


AS6a/rO 


new proj 




parse file init nnme 


AS68/rO 


new_smf 


AZ03/rO 


parse file $ 


AK50/rO 


new user 




parse file init ptr 


AK50/rO 


new user$cg 


AZ03/rO 


parse file $ 


AK50/rO 


new user$cga 




parse file line no 


AK50/rO 


new user$change 


AZ03/rO 


parse_file_$ 


AK50/rO 


new user$install ^ 


- 


parse file__ptr 


AK50/rO 


new user$new user 


AZ03/rO 


parse file $ 


AK50/rO 


new_user$nu 




parse file set break 


AK50/rO 


new user$nua 


AZ03/rO 


parse file $ 


AG92/r2 


ngreater (AF) 




parse file uns(3t bre 


AG92/r2 


nless (AF) 


AK50/rO 


pass util 


AG92/r2 


nondirectories (AF) 


AG92/r2 


pat 


AG92/r2 


nondirs (AF) 


AR97/aA 


patch firmware 


AG92/r2 


nonlinks (AF) 


AN53/rO 


patch ring zero 


AG92/r2 


nonsegments (AF) 


AG92/r2 


path (AF) 


AG92/r2 


nonsegs (AF) 


AZ03/rO 


pause 


AG92/r2 


not (AF) 


AG92/r2 


pb 


AZOJ/rO 


nothing 


AK92/aB 


pbm 


AZOj/rO 


nt 


AR97/aA 


pcd 


AK92/aB 


object info_ 


AZ03/rO 


pcd 


AK92/aB 


object_info_$brief 


AG92/r2 


pd (AF) 


AK92/aB 


object info_$display 


AK50/rO 


pdt copy 


AK92/aB 


object info $long 


AG92/r2 


pdwd 


AN3j/rO 


od_355 


AZ03/rO 


pel 


AN53/rO 


od cleanup 


AZ03/rO 


pem 


AN'3i/rO 


od_print_ 


AZ03/rO 


peo 


AN^j3/rO 


od print $op finish 


AZ03/rO 


peol 


AN5i/rO 


od_print_$op_fmt_line 


AG92/r2 


Pg 


AN33/rO 


od print $op init 


AG92/r2 


pgt 


AN'jj/rO 


od print $op new page 


/^G92/r2 


pi 


AN5j/rO 


od_print_$op_new_seg 


kQ92/r2 


pll 


AN5i/rO 


od stack 


AG92/r2 


pll abs 


AN'3i/rO 


ol dump 


AK92/aB 


pli 
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AK92/aB plu 

AG92/r2 plus (AF) 

AG92/r2 pm 

AS68/rO pmf 

AS68/rO pmisc 

AN52/rO pmlm 

AG92/r2 pmotd 

AR97/aA poll_mos_memory 

AG92/r2 ppa 

AN52/rO pph 

AG92/r2 pr 

AZ03/rO prelink 

AK92/aB prepare_mc_restart_ 

AK92/aB prepare_mc_restart_$ 

replace 

AK92/aB prepare_mc_restart_$ 

retry ~~ 

AK92/aB prepare_inc_restart_$tra 

AZ03/rO pri 

AG92/r2 print 

AN53/rO print_apt_entry 

AN53/rO print_aste_ptp 

AG92/r2 print_attach_table 

AG92/r2 print_auth_names 

AK92/aB print_bind_map 

AG93/aD print_cobol_error_ 

AG93/aD print_cobol_error~$ 

switch ~ 

AR97/aA print_conf iguration_deck 

AZ03/rO print_configuration_deck 

AG92/r2 print_def ault_wdir 

AK50/rO print_devices 

AK50/rO print_disk 

AN53/rO print_dump_seg_name_ 

AN53/rO print_dump_seg_name_$ 

get_ptr 

AN53/rO print_dump_seg_name_$ 

hard 



AN53/rO 


print 


_di!rnp_tape 


AZ03/rO 


print] 


_error message 


AN52/rO 


print' 


'gen_info_ 


AR97/aA 


print" 


heals message 


AK50/rO 


print' 


]iod_tables 


AK92/aB 


print" 


'link_info 


AK92/aB 


print' 


linkage usage 


AK50/rO 


print 


]log 


AG92/r2 


print" 


'messages 


AK50/rO 


print 


^meters 


AG92/r2 


print 


'motd 



AN52/rO 
AK51/r1 
AK50/rO 
AG92/r2 
AK50/rO 
AZ03/rO 
AK50/rO 
AG92/r2 
AK50/rO 
AG92/r2 
AK50/rO 
AR97/aA 
AG92/r2 

AN52/rO 
AK50/rO 
AG92/r2 
AK50/rO 
AZ03/rO 
AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AS68/rO 
AK51/r1 
AG92/r2 
AG92/r2 
AN52/rO 
AG92/r2 
AG92/r2 
AG92/r2 
^G92/r2 
AG92/r2 
AG92/r2 
AG93/aD 
/^G93/aD 
^G93/aD 
AG93/aD 

AG93/aD 
AG93/aD 
AG93/aD 
AG93/aD 
AG93/aD 
AG93/aD 
/\G93/aD 
AG93/aD 
AG92/r2 
AZ03/rO 



print_paging_histogram 
print_pdt 
print_pnt 
print_proc_auth 
print_projfiIe 
print_relocation_inro 
print_reqf ile 
print_request_types 
print_sat 

print_search_rules 
print_syserr_log 
print_syserr_log 
print_translator_ 
search_rules ~ 
print_tuning_parameters 
print_urf 
print_wdir 
priv_move_quota 
privileged_prelink 
probe 
profile 

program_interrupt 
progress 
proj_mtd 

proj_usage_report 
prt 
psr 
ptp 
ptsr 
pwd 
qedx 

query (AF) 
quotient (AF) 
qx 

randora_ 

random~$exponentlal 
random__$exponential seq 
random_$get_seed 
random_$ normal 
random__$normal_ant 
random_$normal _ant_seq 
random_$normal^seq~ 
random_$set_seed 
random_$uniform 
random_$uniform_ant 
random_$uniform_ant soc] 
random_$uniform_seq ' 
re 
rdc 
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AG92/r2 
AG92/r2 
AG92/r2 
AG92/r2 
AK92/aB 
AK92/aB 
AG92/r2 
AG92/r2 
AG92/r2 
AK50/rO 
AZ03/rO 
AK50/rO 
AK50/rO 
AK50/rO 
AG93/aD 
AS68/rO 
AZ03/rO 
AS68/rO 
AK50/rO 
AG92/r2 
AK92/aB 
AG93/aD 
AK50/rO 
AK50/rO 
AK50/rO 
AG92/r2 
AS68/rO 
AK92/aB 
AZ03/rO 
AG92/r2 
AG92/r2 
AK50/rO 
AK50/rO 
AK92/aB 
AK50/rO 
AZ03/rO 
AK50/rO 
AK50/rO 
AZ03/rO 
AG92/r2 
AG92/r2 
AK50/rO 
AG92/r2 
AG92/r2 
AZ03/rO 
AZ03/rO 
AZOj/rO 

AZOj/rO 



_allowed_ 
"write allowed 



rdf 

rdn 

rdy 

re 

read 

read^ _ _ 

ready ~ "~ 

ready_off 

ready_on 

rebuild_dir 

rebuild_dir 

reclassify_dir 

reclassify_seg 

reclassify_sys_seg 

record_stream_ 

recov 

reduction_compiler 

register 

register rnd 1 r 

release ~ 

release_area_ 

release_terap_segments_ 

remove_user 

remove_user$persnt 

remove_user$urf 

rename 

rename_proj 

reorder_ar chive 

repeat_line 

repeat_query 

reprint_error 

resetted t__mete rs 

reset_disk_meters 

reset_external_variables 

reset_soos 

reset_tpd 

reset_usage 

reset_use_totals 

resetcopysw 

resource_usage 

response (AF) 

restore_pdt_access 

rf 

rfa 

ringO_get_ 

ringO_get_$def inition 

ringO_get__$ 

def inition_given_slt 
ringO get $name 



AZ03/rO 


ringO_get_$ names 


AZ03/rO 


ringO_get_$segptr 


AN69/rO 


ring 1 lock 


AN53/rO 


ring zero dump 


AG92/r2 


rl 


AG92/r2 


rn 


AZ03/rO 


rpl 


AS68/rO 


rqm 


AG92/r2 


ru 


AG92/r2 


run cobol 


AG92/(r2 


runoff 


AG92/r2 


runoff abs 


AG92/r2 


sa 


AK50/rO 


sac 


AG92/r2 


safety_sw_off 


AG92/r2 


safety sw on 


AK50/rO 


save dir info 


AZ03/rO 


save dir infg 


AG92/r2 


sbc 


AG92/r2 


scl 


AG92/r2 


scr 


AG92/r2 


search (AF) 


AG92/r2 


segments (AF) 


AG92/r2 


segs (AF) 


AK50/rO 


send admin command 


AG93/aD 


send mail 


AG92/r2 


send message 


AG92/r2 


send_message acknowlecif^c 


AG92/r2 


send message express 


AG92/r2 


send_message silent 


AG92/r2 


set acl 


AG92/r2 


set bit count 


AG92/r2 


set cc 


AG92/r2 


set com line 


AK50/rO 


set_dir quota 


AG92/r2 


set iacl dir 


AG92/r2 


set iacl seg 


AG93/aD 


set_lock 


AG93/aD 


set lock $lock 


AG93/aD 


set lock $unlock 


AK92/aB 


set_max length 


AK51/r1 


set mdir account 


AK51/r1 


set mdir owner 


AK51/r1 


set_mdir quota 


AR97/aA 


set_mos_polling time 


AK50/rO 


set pnt audit 


^KbO/rO 


set pnt auth 


AK50/rO 


set pnt gpw 


AR97/aA 


set_proc required 
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AK92/aB set_ring_brackets 
AK50/rO set_sat_audit 
AK50/rO set_sat_auth 
AG92/r2 set_search_rules 
AK50/rO set_sons_volume 
AK^O/rO set_system_priv 
AK50/aA set_system_search_rules 
AK92/aB set_system_storage 
AZ03/rO set_timax 
AZ03/rO set_tpcl 
AK50/rO set_tpp 
AG92/r2 set_translator_ 
search_rules 
AG92/r2 set_tty 
AK92/aB set_user_storage 
AK51/r1 set_volunie_quota 
AZ03/rO setcopysw 
AS68/rO setcrank 
AS68/rO setdisk 
AG92/r2 sid 
AK92/aB signal 
AG92/r2 sis 
AG92/r2 slave 
AN52/rO slm 
AG92/r2 sm 
AG92/r2 sma 
AK92/aB sml 
AG92/r2 sms 
AG92/r2 smx 
AG92/r2 sort 
AZ03/rO sort_items_ 
AZ03/rO sort_items_$bit 
AZ03/rO sort_items_$fixed_bin 
AZ03/rO sort_items_$float_bin 
AZ03/rO sort_iterns_$general 
AZ03/rO sort_iterns_$ 

varying_char 
AZ03/rO sort items indirect 
n4.u^/iu isort__items_inairect $ 

adj_char "" 
AZ03/rO sort_items indirect $ 

bit 
AZ03/rO sort_iteras_indirect_$ 

fixed_bin ~ 
AZ03/rO sort_items_indirect_$ 

float_bin ~ 
AZ03/rO sort_items_indirect_$ 

general ~ 

AZ03/rO sort_items_indirect_$ 

varying-char 



AK50/rO 

AK50/rO 

AG92/r2 

AG92/r2 

AN52/rO 

AN52/.rO 

AN52/rO 

AR97/aA 

AG92/r2 

AK92/aB 

AG92/r2 

AG92/r2 

AG92/r2 

AG92/r2 

AG92/r2 

AG92/r2 

AG92/r2 

AZ03/rO 

AG92/r2 

AK50/rO 

AG92/r2 

AG92/r2 

ftG92/r2 

AG92/r2 

AG92/r2 

AK92/aB 

/^K92/aB 

AK92/aB 
AK92/aB 
/^K92/aB 

AK92/aB 

AK92/aB 
^K92/aB 
AK92/aB 
AK92/aB 

AK92/aB 
AK92/aB 

AK92/aB 

AK92/aB 
AK92/aB 
AK92/aB 
AK92/aB 



sort_projfile 

sort_reqf ile 

sort_seg 

spe (AF) 

spg 

spg_ring_0_info_ 

spg_util_ 

sprq 

sr 

srb 

ss 

ssf 

ssn 

ssr 

st 

start 

status 

stm 

stop_cobol_run 

stpp 

string (AF) 

strip (AF) 

strip_entry (AF) 

stsr 

stty 

stu_ 

stu_$ 

decode runtime_value 
stu_$fin3'_block 
stu_$find_header 
stu_$ 

f ind_runtime_symbol 
stu_$ 

get_iniplicit_qual Lfier 
stu_$get_line 
stu_$get_line_no 
stu_$get_location 
stu_$ 

get_runtime_address 
stu_$get_runtime block 
stu_$ 

get_runtime_line no 
stu_$ . 

get_runtime_location 
stu_$get_statement_niap 
stu_$offset_to_po inter 
stu_$pointer to_offset 
stu $remote Tormat 
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AK92/aB sub_err_ 

AG92/r2 substr (AF) 

AG92/r2 suffix (AF) 

AK'30/rO sweep 

AK':)l/rl sweep 

AZ03/rO sweep_disk_ 

AG93/aD 5yn_ 

AK^jO/rO sys_full_report 

AK92/aB sys_info 

AG92/r2 system (AF) 

AK50/rO system_daily_report 

AK92/aB system__info_ 

AK92/aB system_info_$abs_prices 

AK92/aB system_info_$ 

access_ceiling 
AK92/aB system_info_$ 

category_names 
AK92/aB system_info_$ 

clevice_prices 
AK92/aB system_info_$ 

installation_icl 
AK92/aB system_info_$ 

io_prices 
AK92/aB system_info_$ 

last_shutdown 
AK92/aB system_info_$ 

level_names 
AK92/aB system_info_$ 

next_shutdown 
AK92/aB syste!n_info_$ 

prices 
AK92/aB system_inf o_$ 

shift_table 
AK92/aB system_info_$sysid 
AK92/aB system_info_$timeup 
AK92/aB system_info_$titles 
AK92/aB system_info_$users 
AN52/rO system_link meters 
AK50/rO system_montHly_report 
AN52/rO system_performance_graph 
AK50/rO system_total 
AG92/r2 tc 
AN52/rO tern 
AN52/rO tcq 
AZ03/rO teco 
AG93/aD term_ 
AG93/aD term_$ref name 
AG93/aD term_$seg_ptr 
AG93/aD term $single refname 



AG93/aD term_$unsnap 
AG92/r2 terminate 
AG92/r2 terminate_refname 
AG92/r2 terminate_ref name 
AG92/r2 terminate_segno 
AG92/r2 terminate_segno 
AG92/r2 terminate_single refname 
AG92/r2 terminate_single_ref name 
AR97/aA test_cpu 
AR97/aA test_tape 
AG92/r2 time (AF) 
AK92/aB timer_manager _ 
AK92/aB timer_manager_$ 

alarm_call 
AK92/aB timer_manager_$ 

alarm_call_inhibi t 
AK92/aB timer_manager_$ 

alarm_wakeup 
AK92/aB timer_manager_$ 

cpu_call 
AK92/aB timer_manager_$ 

cpu_call_inhlb it 
AK92/aB timer_manager_$ 

cpu_wakeup 
AK92/aB timer_manager_$ 

reset_alarm_call 
AK92/aB timer_manager_$ 

reset_alarm_wakeup 
AK92/aB timer_manager_$ 

reset_cpu_call 
AK92/aB timer_manager_$ 

reset_cpu_wakeup 
AK92/aB timer_manager_$ 

sleep 
AG92/r2 times (AF) 
AN52/rO tin 
AG92/r2 tm 
AG92/r2 tmr 
AG92/r2 tmr 
AG92/r2 tms 
AG92/r2 tms 
AG92/r2 tmsr 
AG92/r2 tmsr 

AN52/rO total_time_meters 
AG92/r2 trace 
AG92/r2 trace_stack 
AN52/rO traf f ic_control meters 
AN52/rO traf fic_ control queue 
AZ03/rO translator info 
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AZ03/rO translator_info_$ 
get_source info 
AK50/rO trirn_syserr Tog 
AG92/r2 trunc (AF)~ 
AG92/r2 truncate 
AR97/aA truncate heals log 
AG92/r2 ts - "" 
AK92/aB tssi_ 

AK92/aB tssi__$clean_up_file 
AK92/aB tssi__$clean_up_segment 
AK92/aB tssi_$finish_file 
AK92/aB tssi_$finish segment 
AK92/aB tssi_$get_fiTe 
AK92/aB tssi $get segment 
AN52/rO ttm ~ 
AG93/aD tty 
AK92/aB tty 
AK50/rO tty~lines 
AN52/rO tty_lines 
AN52/rO tty_meters 
AN52/rO ttym 
AG92/r2 ul 

AG92/r2 unassign resource 
AS68/rO undelegate 
AG92/r2 underline (AF) 
AG92/r2 unique (AF) 
AG93/aD unique_bits_ 
AG93/aD unique chars 
AG92/r2 unlink 
AK92/aB unwinder 
AK50/rO up_ctr ~ 
AR97/aA update heals log 
AS68/rO upmf ~ ' 
AG92/r2 ur 
AK50/rO^ urfp 

AK50/aA' usage_and_revenue 
AK50/rO usage total 
AG92/r2 user ""(AF) 
AG93/aD user_info__ 
4G93/aD user_info~' 
AG9j/aD user_info~$ 

absentee_queue 
AG93/aD user_info_$absin 
AG93/aD user_info_$absout 
1^09 5 /aD user_info_$ attributes 
AG9i/aD user_info_$homedir 
AG93/aD user_info_$limits 
AG93/aD user_info_$ 

load ctT info 



AG93/aD user_info_$login_data 

AG93/aD user_info_$logout_data 

AG93/aD user_info_$outer_module 

AG93/aD user_info_$responder 

AG93/aD user_info_$tty data 

AG93/aD user_info_$usage_data 

AG93/aD user info $whoami 

'IKSO/rO value 

AS68/rO value 

AS68/rO value$dump 

AS68/rO value$set 

AK50/rO value$set seg 

AG92/r2 verify (AF) 

AG92/r2 vfa 

AG93/aD vfile 

AK92/aB vfile" 

AG92/r2 vfile adjust 

AG92/r2 vfile~status 

AG93/aD vfile status 

^G92/r2 vfs ~ 

AG93/aD virtual_cpu_time 

AZ03/rO vtoc_pathnarae ~ 

AG92/r2 walk subtree 

AG92/r2 wd TaF) 

AG92/r2 wh 

AG92/r2 where 

AG92/r2 who 

AS68/rO who_delg 
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SECTION I 
INTRODUCTION 



The purpose of this document is to aid the user in understanding 
errors that may occur during use of Multics. The standard Multics 
error reporting mechanism is introduced, and the meaning of error 
messages is explained. Possible causes of many errors are discussed, 
and when applicable, methods for recovering from, or circumventing an 
error are presented. 

HOW TO READ THIS DOCUMENT 

This document is intended for use by novice users or applications 
programmers unfamiliar with the Multics programming environment. As a 
result, the kinds of errors covered and the examples given have been 
tailored to this audience. 

The discussion of error conditions is divided into four sections. The 
first explains command processor errors. This includes all errors 
that arise in the interpretation of commands, and the formation of 
command names and command arguments. The second section, entitled 
"Command Errors", deals with errors that are detected by commands 
themselves. For example, an editor will report an error when a 
request is issued to read a nonexistent file. The third section 
discusses execution errors: hardware (simulated) conditions that 
arise during the execution of programs. Examples of this class of 
errors include zero divide, subscript range, and segment fault. Such 
errors may occur in user or system programs and generally indicate the 
presence o* a program bug. As a result, this section is of the 
greatest use to programmers creating and debugging a new program. The 
fourth section covers fatal process errors. These are similar in 
origin to execution errors, but cause the user's process to be 
aborted. Language-specific errors such as input/output, BASIC run 
time errors, etc. are not covered by this memo. 

Each section describes the most commonly occurring errors of the 
particular class. Console scripts, along with descriptive 
commentaries, are used to present typical examples of the error, the 
methods used to determine the actual cause of the error, and means for 
recovering from the error. The memo is partially tutorial; however, 
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for complex explanations, the user will be referred to the MPM. 

This document may be used as a reference for individual errors. 
However, it is felt that the reader would benefit by at least one 
reading from cover to cover. This should provide experience with 
errors that otherwise could only only be obtained by a long period of 
actual use. Furthermore, many errors have related causes and 
consequently related methods for analysis, and since, in general, a 
topic is explained in full detail only once, a thorough reading will 
help the user see how a specific technique or error falls into the 
overall scheme. Finally, the reader should find a number of 
worthwhile hints that enable him or her to avoid problems in the first 
place. 

User feedback is solicited concerning errors in this document, awkward 
or incomprehensible explanations, common problems that have been left 
out, etc. 

THE PROGRAMMING ENVIRONMENT 

To obtain a good understanding of errors and their causes, it is 

too, it is simply a misunderstanding that is the cause of the error.) 
Below is a brief and simplified discussion of the basic features and 
terminology of the Multics programming environment. Refer to the MPM 
Reference Guide (Order No. AG91) for more detailed information. 

A process is a computation or execution activity much like a job on 
other computer systems. The term refers, collectively, to the program 
or group of programs in execution, the current value of program 
variables, the address space (the temporary and permanent segments of 
memory that have been referenced), the files and other input/output 
devices (e.g., console, tape volumes) in use, and various 
system-maintained data bases. What is important to the programmer is 
the duration of the process, since it maintains the programming 
environment. When the user first logs in (1) a new process is 
created. At this time, all per process information is put into a 
consistent initial state. There are no files or devices attached 
besides the terminal; all program variables are (in effect) set to 
their initial values; and so forth. A process is terminated when the 
user logs out, gives the new__proc command, or a fatal error occurs. 

On Multics, programs and their data reside in a virtual memory or 
address space . This consists of (potentially) a large number of 
disjoint se gments of storage. Each such segment may contain up to 
255K (K = 102^) words of storage, and has a name by which it may be 
accessed. An address (pointer) designating a specific location in the 

( 1 ) Or equivalently an absentee job is logged in at the user's request- 
by the system, in which case, the console is replaced by the absentee 
input segment. 
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virtual address space is a pair of numbers: a segment number and an 
offset within the segment. When a segment is to be used, it is 
initiated forming a mapping between the name and a segment number' 
This mapping remains valid for the duration of a process, or until the 
segment is explicitly terminated. Use of 3n invalid segment number 
in particular a segment number generated in another process is a 
common source of errors. (See the description of the segment fault 
error.) An offset within a segment, on the other hand, remains valid 
as long as the contents of the segment are not modified. This means 
for example, that it is possible to save the offset part of an address 
across processes and reuse the offset with a segment number generated 
in the new process. (1) Errors occur in the use of offsets if the 
value of the offset is out or range: negative or greater than 255K. 
(A lower limit can be set by explicit programmer action, if desired ) 
See the discussion of out of bounds errors, 

A segment may be designated by one of two naming conventions- 
pathnames and reference names. In general, a segment is specified by 
pathname when accessed by commands, and by reference name when 
accessed from a program as an external symbol (e.g., the name of an 
external subroutine). 




directories need ..v.v, uc uxauinct. m aaaition to segments. .. 
directory may contain other subdirectories. The Multics file system 
is organized as a tree with a root directory that contains all other 
directories as subdirectories, subsubdirectories , etc 



rl!fr^;^L^''°^''®"""^rf "^y realize the similarity between this and the 
restrictions on the use of based areas and offsets on other svstems 
Programs are not allowed to save pointers to data alloca?e5 within th^ 
thl S^?J^\.'' ^^^ because while the area may retain its integrity, 
the actual address may change. The same reasoning applies to segment 
numbers and offsets, and to areas on Multics saved from proclsf to 
process. yt ^^tii,i> 1.0 
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/ \ 

f \ 

/ \ 

(a) (f) 

A pathname, then, is an ordered list of entrynames designating the 
directories containing the entry and the entry itself. It gives the 
path from the root to the segment. In the diagram above, squares 
represent directories and diamonds represent segments. The following 
are all valid pathnames within that hierarchy: 

>d1>a 
>d2>a 
>d2>a>a 

In addition to segments and directories, a directory may also contain 
links . A link is a pathname pointing to another entry (usually in 
another directory); it allows that entry to be accessed as if it were 
cataloged in the directory containing the link with the name(s) of the 
link. In the diagram above, links are presented by triangles with 
dotted lines leading to the target of the link. 

>d1>c and >d2>a, 
and >d1>c>f and >d2>d 

refer to the same directory and segment respectively. If a link 
points to another link, then the entry pointed to by the second link 
becomes the ultimate target. 

There are two forms of pathnames. An absolute pathname contains the 
entrynames of all the containing directories^ FHat is, it fully 
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specifies the position of something (i.e., segment, directory, link) 
within the directory hierarchy. A relative pathname , on the other 
hand, gives the position of an entry relative to the work ing 
directory . A relative pathname is expanded into an absolute pathname 
by logically concatenating the pathname of the working directory to 
the relative pathname given. For example, if the working directory 
were >d2>a from the the diagram above, the relative pathname "f" would 
be the same as the absolute pathname >d2>a>f . It is possible to move 
upwards in the hierachy by using "<"s in a relative pathname. Thus 
with the same working directory as above, <d would be the same as 
>d2>d. The working directory is initially the user»s home directory , 
normally >udd>Project ID>Person ID; it may be changed by the user 
with the change__wHir (cwdT command. Absolute pathnames ar^ 
distinquished from relative ones by a leading ">". 

The term segment is often confused with the term file . Strictly 
speaking, a file is storage accessed through explicTT'input/output 
operations. In principle, there are no limitations on the size of a 
file; it may get as large as is necessary, far exceeding the 255K 
word limit of a segment. Those files smaller than 255K are placed in 
a single segment. Unstructured files of character data are the same 
as text segments. That is, they may be created or modified in an 
editor, printed, or sorted. Structured files (those containing 
nonprintable "binary" data) should not be aeessed except through I/O 
facilities. Those files larger than 255K are implemented as 
multisegment files . The data is stored in several segments which 
should only be accessed by I/O mechanisms. Even if the file contains 
only printable text, there are currently no mechanisms for editing it 
and guaranteeing the authenticity of the file. A multisegment file is 
cataloged in a directory like any other entry. In this memo the 
distinction between file and segment will be strictly adhered to.* 

^ reference name is the name by which a segment is referenced (e.g., 
called) during the execution of a program. It consists of the 
entryname of the segment; the absolute pathname of a particular 
segment is determined by applying the search rules in effect for the 
process. They are as follows. 

1. A list of reference names already known within the process is 
checked; if the entryname being searched for is found, the 
associated segment is used. A name becomes known when the 
search rules are first used to reference a segment with that 
entryname or when a specific segment is initiated and a 
reference name (which need not be an entryname of the segment) 
is specified for the segment. 

2. The directory containing the program making the reference is 
checked for a segment with the entryname. If found, the 
segment found becomes known by the reference name, 

3. Each of an ordered list of directories is checked for a 
segment with the correct entryname. If found, the segment 
becomes known by the reference name. Initially, this list 
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starts with the user's working directory and is followed by 
the list of system libraries. Alterations may be made to this 
list of directories by using the add_search rules command. 
For example, the working directory (whicTi is logically 
specified as "working_dir" and whose meaning changes as the 
working directory is changed) may be moved to follow the 
system libraries, or a specific user directory may be added to 
the search rules. 

Once a reference name is associated with a particular segment, it 
remains in effect (rule 1) until the process is terminated or until 
the segment is terminated by using the terminate command. This can 
cause unexpected results for the unsuspecting user. In the sample 
hierarchy given above, if the user's current working directory is >d1 
and he or she executes the procedure a in that directory, it will 
become known by the reference name a. If later, he changes to a new 
working directory, >d2>a, and executes the procedure f which calls a 
subroutine a, then the segment with reference name a found by the 
search rules will not be the segment >d2>a>a, but rather the segment 
previously known by that reference name, >d1>a. 

For each process, the system creates a process directory . This 

^J X I CrV»U^/l y W V/ H W a J. 11 u \f\,nty^^t w • jr u wi w u •^'w |Q>i<%. >• w w u • < 'w t^ yy^ •^ Jk. \m ^ w ^ (>,>■< -^ >> w w ^.. 

which program data and system control information are stored. The 
stack is one such segment and contains records of current procedure 
activations and the automatic storage used by these procedures. The 
combined linkage segment contains the linkage sections of procedures 
which hold the internal static data used by a program. The identity 
of these segments can be important in determining the cause of an 
error. When an error occurs, the segment containing the data being 
referenced will be given when appropriate. If the segment is the 
stack, it is a strong clue that the operation causing the error was 
making use of a datum of automatic storage. Similarly if the segment 
is the combined linked segment (combined_linkage__r .nn) , it is likely 
that static data is involved. Often such a clue can be used to 
isolate the cause of an error in the absence of other debugging 
information such as the line on which the error occurred. 
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The list of procedure calls contained in the stack is an extremely 
useful source of debugging information. Consider the following 
example. Assume that a procedure A is executing. It then calls 
procedure B. B in turn calls C. When C has finished executing, it 
returns and B continues from the point at which it called C. B 
eventually returns, and A then calls the procedure C. At each step, 
it is possible to construct an ordered list of the procedure 
invocations indicating which program called which other program and 
the location in a program at which it called out. Graphically, this 
list may be represented as follows: 

C 
B B B C 

A A ' A A A 

A calls B B calls C C returns B returns A calls C 

In the figure above, the most recently called procedure is on top. 
Such a stack trace is particularly useful to understand the sequence 
of calls that lead up to an error. The probe and trace_stack commands 
may be used to obtain a stack trace. Examples of the use of the probe 
command are given in later sections. A block is act i vated when a 
procedure or subroutine is called or a begin "Flock is entered. 
Activation causes dynamic allocation of storage for a program's 
automatic variables. The area allocated is placed at the end (top) of 
the process's stack and is called a stack frame . When the procedure 
returns, the stack frame is freed. This means that variables of the 
automatic storage class (1) only have storage assigned to them (and 
hence a legitimate address and value) when the block in which they are 
declared is active (i.e., its execution is ongoing or suspended as the 
result of an error condition, a quit signal, a call, or a debugger 
breakpoint). When a procedure is called recursively, it has frames on 
the stack for each activation. Each instance of the procedure on the 
stack is considered a separate and distinquishable activation of the 
procedure. The values of automatic variables and parameters can be 
(and usually are) different in different activations of the same 
procedure. 

Within a process, PL/I static variables and Fortran variables have a 
continuity of value. That is, the value of such a variable is 
initialized only once during a process, when a program in which the 
variable is defined is first invoked; subsequent modifications to the 
value of the variable will remain in effect, even through new 
activations of the procedure, until the process is terminated. (2) 



(1) PL/I variables, by default, belong to the automatic class. 
FORTRAN variables appearing in an automatic statement (a nonstandard 
Multics feature) are also of this class. 

(2) PL/I internal static variables or Fortran variables that are not 
in common may be reinitialized by terminating the segment. External 
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CONVENTIONS 

The examples in this document follow certain conventions. All lines 
typed by the user are prefixed by an exclamation point ( ). A quit 
signal issued by the user by pressing the QUIT, ATTN, or BREAK keys on 
the terminal is indicated by "(quit)" appearing to the left of the 
normal text of the example. When a line of output is too long to be 
placed on a single line, it is broken at an arbitrary point. This 
should not affect the user's understanding of the example. In ready 
messages output by the system on the completion of a command line, a 
dot (.) replaces information, such as the time of day, irrelevant to 
the example being presented. Finally, many lines of input or output 
whose content should be obvious from the example is replaced by 
ellipsis (...). In all other respects, an attempt has been made to 
produce examples which are accurate. Most are simply modifications of 
the output from test error situations. 



and comraoned variables may be reinitialized only by using the new^pro*. 
command to obtain a new process. 
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SECTION II 
COMMAND PROCESSOR ERRORS 



These are errors that are detected by the command processor When this 
kind of error is detected, a message is printed on the console, (along 
with a ready message) , and then the system waits for the user to type 
another command. Once the cause of the problem has been determined, 
the user may retry the (corrected) command. 

These errors may often be caused by a garbled telephone connection 
between the user's terminal and the computer. If there is no apparent 
cause for an error, reenter the same command line again. 

SEGMENT NNNN NOT FOUND 

This means that reference name NNNN did not match any reference or 

entryname within the user's search rules. The most common cause of 

the error is incorrectly specifying (through mistyping or a 
misconception) the command name. 

For example, suppose that a user had a program called colour, but 
mistakenly typed "color" when calling it: 

color 

Segment color not found, 

r . • • • 

list 

Segments = 3, Length s 3. 

re 1 colour 

r w 1 colour.pn 

rew 1 PJApple.mbx 

1 . • • • 

colour 
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Here the user gets the error, then uses the list command to see if 
there was something wrong with the name. Finding the mistake, the 
command line is retyped with the corrected name. 

This error is virtually identical to the "segment not found" case of 
linkage errors. See that discussion below for additional examples. 

ENTRY POINT EEEE NOT FOUND IN SEGMENT 

«.i_4_ 4_j^--4.^« 4.u^4- p. ci<»ffmArtf ma^nhina f-ho rAf«*r#»ncia name NNNN was 
found in the user's search rules, but it did not contain the entry 
point called EEEE. To determine what entry points are actually 
present in a program (or other type of object segments) the 
print link_info command may be used. 

colour 

Entry point colour not found in segment colour. 



.... 



pli colour -entry 



colour \jd/uo/(v iijMu.t coi# iiiu 



3 Definitions: 

segname: c 

symblO s. 

text! 17 colour" Entry: text! 17 



segname: colour 
symbiO symbol_table 



colour$color 

• • • 

In the above example, a segment matching the reference name colour 
(see previous example) was found but it did not contain an entry point 
"colour". The pli command gives the "segname" or the name by which 
the program was known when it was compiled; the only "entry" defined 
is one called "color". The user corrects the line by giving a command 
name that contains both the reference name and entry point' name 
separated by a "$". Another way to correct the error would be to 
rename the program ( both the source and the object segments ): 

rename colour. •• color. == 

• . . . • 

color 
r • . * . 

In this way, the segment now has the same entryname and entry poin' 
name and can therefore be called as a command by giving only it;. 



2-2 



entryname. (1) 

The problem illustrated here occurs quite often when the program 
contains a procedure with a different name than that given to the 
segment containing the text of the program. 

edm colour. pll 

Input. 

color: procedure; 



end color; 

Edit, 
w 

q 

r . . • • 

There are a number of other causes for this error. The entrypoint may 
have been deleted by binding. 

This error is virtuall^^ identical in cause to the "external definition 
not found" case of linkage errors. See that discussion below for 
additional examples. If the meaning of reference names versus 
entrynames and entry point names is confusing, see the MPM Reference 
Guide , Section III, Constructing and Interpreting Names. 

EXPANDED COMMAND LINE IS TOO LONG 

This error arises when an active string has been used, and the string 
returned overflows the currently allocated size for the command line. 
The user may recover by using the set_com_line command to set the 
command line length to some arbitrarily~large value (e.g., 3000) and 
reissuing the command line. Below, the active string segs is invoked 
to return a string containing the names of all PL/I and Fortran source 
segments; this string overflows the command, line length. 

archive ad saved_programs [segs *.pl1 *.fortran] 
command processor : Expanded command line is too long. 



.... 



set_com_line 3000 
•^ .... 

archive ad saved_programs [segs '.pll *.fortran3 
i .... 



(1) For an explanation of the star and equals convention, see the MPM 
Reference Guide , Section III, Constructing and Interpreting Names. 
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IMPROPER SYNTAX IN COMMAND NAME 

This error is issued when the user has specified a command name which 
is not in the standard form of a reference name, optionally followed 
by the special character "$" and an entry point name. Examples of 
correctly formed command names are: 

ref_name ref_name$entry_point_name 

Examples of incorrectly formatted names are: 

name$ $name 

More detailed information may be found in Section III of the MPM 
Reference Guide . 

BAD SYNTAX IN PATHNAME 

This means that the pr^ogram to be invoked was specified by an 
incorrectly formed absolute or relative pathname. See the discussion 
of the error in the Command Errors section. 

PARENTHESES DO NOT BALANCE 

This means simply that a parenthesis beginning an iteration set wa^ 
unbalanced. For example: 

create >udd>Serpent>PJApple>(output1 outputs 
command_processor^: Parentheses do not balance. 

r .... 

What was intended was "(outputi output2)" to create two segments. 
This error is handled by reentering a command line containing a 
balancing parenthesis. 

The problem may arise when iteration of a command is not intended. 
For instance, the "send_message" command which transmits its arguments 
to another party. 

send_message BDLucifer Serpent delete the files (in PJApple>old 
command_processor_^: Parentheses do not balance, 
r "~ 



.... 



Here the intent is to send a message containing a parenthetical 
thought. If the command line were reentered with a trailing 
parenthesis, two messages would be sent. That is, the user named 
would receive 

from PJApple. Serpent: delete the files in 

s: delete the files PJApple>old 
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Notice that the first message contains the first string in the 
iteration set "(in PJApple>old)", and the second message, the second 
string. This problem may be avoided by enclosing the entire message 
in quotes. 

send_message BDLucifer Serpent "delete the files (in PJApple>old)" 

1 e « e • 

It is advisable to always enclose messages in quotes to avoid 
unintentionally sending someone repeated messages. 

BRACKETS DO NOT BALANCE 

An invocation of an active function (a procedure returning a string to 
be inserted into the command line) is enclosed in square brackets. 
This error simply means that the command line had an unbalanced left 
or right bracket. 

list -pathname [pd 

comroand_processor_: Brackets do not balance. 

r . . » . 

The correct command line would have contained "[pd]" to return the 
name of the user's process directory. The error may be handled by 
entering a corrected command line. 

In a manner similar to that described for the case of unbalanced 
parentheses, an unintentionally balanced active function invocation in 
a "send^message" command line will transmit a message containing the 
value of the active function. The problem may be avoided by enclosing 
the message in quotes. 

QUOTES DO NOT BALANCE 

Quotation marks may be used in a command line to delimit a single 
string argument that contains special characters such as "(", "]", or 
space. The error means that the command line contained an unbalanced 
quote. The error may be remedied by reentering the corrected command 
line. 
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SECTION III 
COMMAND ERRORS 



These are errors detected in the processing of a command. They 
reflect not hardware conditions, but rather software conditions 
concerning, for example, the file system. Command errors are not 
restartable. A message is printed, and the system resumes what it was 
doing (e.g., listening for commands). The cause of the error may be 
fixed, and the command reissued. 

BAD SYNTAX IN PATHNAME 

This means that a pathname (the ordered list of entrynames identifying 
a segment in the storage system) has been formed incorrectly. The 
causes of this errc ' are typing mistakes and an incomplete 
understanding of what a pathname is. (In the latter case, see the HPM 
Reference Guide , Section III, Constructing and Interpreting Names.) 

print >udd>Serpent>>PJApple>a. basic 

print: Bad syntax in pathname. >udd>Serpent>>PJApple>a. basic 

r . . » . 

print >udd>Serpent>PJApple>a. basic 
. . . ' 

Here the user gave a pathname with two ">"s next to each other. As 
this is incorrect syntax, an error message was printed. The user 
recovered by typing the correct pathname. This error will also occur 

■J ^ a H ^ t» annoars Qui" r» T n1 ao** i »^ a r<a1 gf i vo ri ::> ^ h n sm o fVial- i <? af anv 

place other than the beginning of the pathname. For example: 
<<Student<Green>old. runoff 
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INCORRECT ACCESS ON ENTRY 

This means that the user, when logged in under the current project, 
does not have the correct access to a segment to perform a certain 
operation. This error can be dealt with by using the command 
"list_acl" (la) to determine why the user has no access, who can give 
him or her access, and if the user can do it him/herself, use the 
set acl command to set the appropriate access to the segment. 

The error may arise when trying to read a segment or file. For 
example, when reading a segment with an editor (edm or qedx), when 
printing a file (using print or dprint) , or when trying to compile a 
source program. In this case, the user does not have "read" access to 
the segment. For example, the following dialogue might occur for user 
Green logged in under the Serpent project. 

edm color. pi 1 

edm: Incorrect access on entry. >udd>Serpent>PJApple>color .basic 



.... 



list_acl color. pll 

r w BDLucifer .Serpent.* 

r w * .SysDaemon.* 

r . . . . 

set_acl color. pll r 
I . . . . 

edm color. pll 

... 

Here the user has attempted to edit segment color. pll. The edm 
command detects that he does not have read access to the segment, and 
reports an error. By using the "list_acl" command, he finds that only 
one other user on the Serpent project (BDLucifer .Serpent) has access 
to the file. The "set_acl" command is used to give Green. Serpent 
access to the file, and he retries the command over again. The error 
may also occur when writing out a segment that is being edited. In 
this case, the user does not have "write" access to the segment. 

edm color. pll 
Edit. 



w 

edm: Incorrect access on entry. >udd>Serpent>PJApple>color .p] 1 

E set_acl color. pll rw 

Ed it . 

w 

q 
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Here the user tries to save a program that he has been editing, but 
cannot do so because he does not have write access to the segment. He 
is faced with the problem of setting the access on the segment without 
losing the editing that he had done. The edm "E" requests allows him 
to execute a Multics command line, so this feature is used to let him 
invoke the set_acl command to recover from the error. After the 
access is changed, the edm write request may be reissued. If the user 
had been unable to change "Ehe access, he could at least save what was 
done by writing it out into another segment as shown below: 

E set_acl color. pll rw 

set acl: Incorrect access to directory containing entry, 

Edil. 

w color! ,pl1 

q 



INCORRECT ACCESS TO DIRECTORY CONTAINING ENTRY 

This error means that the user on his or her current project does not 
have enough access on the directory in which a segment is (to be) 
cataloged to perform some operation on it. Again, this error can be 
dealt with by using the list_acl and set_acl commands. 

This error most commonly occurs while trying to delete a segment (the 
user lacks modify access), while trying to set the access on a segment 
(lacks modify) while trying to move, create, or copy a segment (lacks 
modify and/or append), or while trying to find out information about 
the segment (lacks status permission). 

status <BDLucifer>souls.list 

status: Incorrect access to directory containing entry. 
>udd>Serpent>BDLucifer> souls. list 



list_acl >udd>Serpent>BDLucifer 
sma BDLucifer.*.* 
sma * .SysDaemon.* 

« • • • • 

list_acl >udd>Serpent 
sma *. Serpent.* 
sma * .SysDaemon.* 

r .... 

set_acl <BDLucifer s 
r , . , , 

status <BDLucifer>souls.list 
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Here the user attempts to find out information about the segment. The 
status command requires at least "s" access to the containing 
directory, and not having it, an error message is issued. The user 
then checks the fact, and looks at her access to the parent of the 
directory containing the segment to see if she can set the appropriate 
access herself. She then gives herself the necessary access, and 
reissues the command. 

SOME DIRECTORY IN PATH SPECIFIED DOES NOT EXIST 

This means that a directory specified in the pathname of a segment 
does not actually exist. 

The way to determine what directory is missing and/or the entryname of 
the directory actually intended is to use the list command. 

print >udd>Serpent>i>Apple>color.pl1 

print: Some directory in path specified does not exist. 

>udd>Serpent>PApple> color. pi 1 
r • . . • 

list -pn >udd>Serpent -dr 

Directories = 2. 

PJApple 
sma BDLucifer 

r . • • • 

print >udd>Serpent>PJApple>color.pl1 



ENTRY NOT FOUND 

This means that a segment specifed was not found in the directory. 
(All the containing directories do exist.) 

This error may be dealt with by using the list command to see if the 
segment exists under some other entryname. The rename or addname 
commands can be used as desired to change the segment's entryname or 
give it an additional entryname. 

A common cause of this error in the case of novice users is misnaming 
the segment. For example, a Fortran source program must have the 
suffix ".fortran". Thus if the segment "main" had been created 
containing the program, an error would ensue: 
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edm main 
Input. 
• • • 
w 

q 

a • • • • 

fortran main 

Fortran 

fortran: Entry not found, main. fortran 

I . . • • 

rename main main. fortran 

I • • • • 

fortran main 
. • • 

If the name identifies a link, then another possible cause of the 
error is that the segment pointed to by the link does not exist. This 
possibility can be checked by listing the link and checking whether 
the target exists. (Note' that the link target may be another link, in 
which case the process must be repeated.) 

INSUFFICIENT ACCESS TO RETURN ANY INFORMATION 

This error arises in the cases described for the above four errors 
when the user does not even have enough Access to determine why the 
operation cannot be performed. The problem is that the user does not 
have status permission on the directory containing a segment or, in 
the second case, to the directory containing the directory containing 
the segment. 

This error can be dealt with as described above by first setting 
access on the containing directory. Usually, a user who receives this 
error will not have access to set the required access, and will have 
to contact the user who controls the directory in question. 

ILLEGAL ENTRYNAME 

This message is generated by an editor when the user tries to write 
from an editor buffer into a segment with a malformed name. A 
malformed name is one which contains special characters such as blank, 
tab, "/" , etc., or which contains missing components. Generally, this 
is a name which would make it difficult to access the segment because 
of system conventions. Examples of illegal names are: 
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a»b 

ho/whose/ 
c. .d 
prog. 

This almost always occurs when the user has given an accidental write 
request. For example: \ 

edm second. fortran 

Edit. 

... 

w = a*b 

edm: Illegal entryname. = a*b 

• * • 

If it is desired to have a segment with a name containing such special 
characters, the segment can be written with a normal name, and renamed 
to the entryname containing special characters. 
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SECTION IV 
EXECUTION ERRORS 



This class of errors includes all hardware and software detected 
faults and conditions. When an error of this sort occurs, a condition 
is signalled. The condition may be handled by a user-supplied 
condition handler (PL/I on unit), or if no on unit is found (as is 
normally the case), the system's on unit. The system's on unit prints 
an error message and invokes a new command level, suspending the 
execution of the program causing the error. This new command level is 
indicated by a ready message with a level number greater than one: 

r 1204 2.039 39.200 3^7 level 2,16 

After an error has occurred, and a new command level entered, the user 
should eventually do one of three things: 

1. Issue a release command to flush execution of the suspended 
program. For example, a quit signal (sent by striking the ATTN, 
BREAK, or QUIT key on the terminal) may be used to stop a run away 
program, or excessive printing. 

looper 
(quit) 

QUIT 

r .... level 3 , . 

release 
r .... 

The release command need not be used immediately after the error 
occurs. If the cause of the error is not obvious, system supplied 
tools (e.g., probe) may be invoked at the new. command level to 
determine the cause. Whether or not this is possible, the release 
command should be issued before doing any additional work (e.g., 
changing and recompiling the program) to avoid more serious and 
incomprehensible errors. 
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The start command may be used to restart the program that was 
interrupted. This is possible if the problem is correctable, or m 
the case of an erroneous computation where the system's on unit 
performs some specified action to correct the condition upon 
restart. Such a correction might be to set the result of the 
computation/ 2 »» -1000, to after an underflow condition has 
occurred. The actions taken by the system on unit are often 
specified in the error message; if not, the user may consult the 
MPM Reference Guide if he or she desires. 

Another common practice is to "quit" out of a program that appears 
to be looping, check the CPU time that it has used by inspecting 
the ready message, and if it is looping, releasing the suspended 
program (after debugging the cause of the loop); otherwise, 
resuming the execution with "start". (Note: quit/starting m this 
way may lose output directed to the terminal. However, under 
certain circumstances, this may be desirable.) 



(ouit) 



(quit) 



count 
1 
2 




QUIT 
r .... 


level 2, . 


start 
6 




7 




QUIT 
r .... 


level 3|. 



release -all 



Here a program named count has been invoked. It was then stopped 
by a quit signal and restarted by the start command; as a result, 
a few lines of output were lost. The program was then stopped a 
second time by a quit signal and aborted by the release command. 
Notice how the level numbers are effected by this sequence. 

3. Issue the new proc command to get a new process. This will 
reinitialize *all static variables, common blocks, I/O attachments, 
files, etc. The use of this command is recommended when 
inexplicable (1) errors occur. Once a new__proc is finished, it is 



(1) Errors for which you can see no apparent reason. For example, you 
followed a memo verbatim; exactly the same thing worked before; an 
so forth. In general, a new^proc should be tried if you have not seen 
the error before and cannot find a ready explanation. 
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advisable (1) to retry the program with which there is a problem. 
Often the problem will disappear. If it doesn't, it is likely that 
a program bug exists, and you should continue to look for some 
other cause. The thing to remember is that an erroneous program 
can cause other programs including system programs to go awry. 

The error messages produced for most of this class of runtime errors 
are in a common format. For example: 

Error: Attempt to divide by zero at >udd>Serpent>PJApple>prog! 13 (line 
system handler for error returns to command level 

The first line gives the type of error "Attempt to divide by zero" the 
pathname of the object segment causing tjhe error (>udd> . . .>prog) , the 
offset in the program object segment of the instruction at which the 
error occurred (13 octal), and, if the program were compiled with the 
"-table" option, the source line number. The second line gives 
additional information about the error. Here it states that a new 
command level will be created. 

In general, an error which occurs in a system program can be traced to 
a user error. (2) In the case of an error. in a system program, the 
user should verify that he has called it properly: that the correct 
number of arguments have been passed, that all documented requirements 
and restrictions have been met, and that all values passed as input to 
the system program have reasonable values. 

When an error occurs in a system program, the location in the user 
program where the system program was called is not given in the error 
message. This location can be determined using the probe command. 



(1) If the cost of program execution prior to occurrence of the error 
is acceptable. 

(2) This is not to say that there are not bugs in system programs, 
however it is more likely that the user did something wrong. 
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prog V 

Error while processing in ring 0: 

Segment- fault error by bound_system_faults|2M330 

referencing 177710 

There was an attempt to use an invalid segment number. 

Entry into lower ring was by 

change_wdir$get_wdir_|476 

(>system_library standard>bound_fscom1_) 

referencing hcs_^fs_search_get_wdir 

r .... levei e: , . 

probe 

Condition seg_fault_error raised at get_wdir_! 163^^ . 
stack 
11 command__processor_ 
10 release^stack 

9 unclaimed^signal 

8 default_error_handler_ 

7 real_sdh_ 

6 get_wdir_ seg_fault_error 

5 prog 

^ command_processor_ 

3 listen^ 

2 process_overseer_ 

1 user_init__admin_ 
use prog 
source 

this -> wdir = get_wdir__ (); 
where source 

Current line is line 9 of prog. 
• • * 

The error message may be interpreted as follows. The error was a 
segment fault error. The message "Error while processing in ring 0" 
indicates that the error occurred in a supervisor program. The 
supervisor program was called from the user ring by the program 
change__wdir$get_wdir__ (which is located in a bound segment in a system 
library). (1) The error message does not indicate what user program 
called these programs. This is determined by invoking probe, and 
issuing special requests to it. The stack request lists the procedure 
activations currently on the user stack (the called procedures). Here 
"get_wdir_" has been called by the user program "prog". The use 
request tells probe to examine "prog", and the source request then 
gives the text of the line at which the error occurs; "where" 
retrieves the line number of that line. Note that these (and most 
other) probe requests can only be used as shown when the program in 
question has been compiled with the -table option. 



(1) The other information is largely irrelevant for the purposes of 
uue casuaj. user. 



RECORD QUOTA OVERFLOW 

This means that the disk storage quota for a directory has been 
exceeded. The problem can be dealt with only by finding or reclaiming 
additional disk quota. Usually, it is possible to have the storage 
quota on a directory increased by the project administrator. (1) 
Quota can also be temporarily reclaimed by deleting unneeded segments, 
or if possible moving a segment to a directory with unused quota. 

This error will occur when a segment is being written into. There are 
three common contexts in which this will occur. Writing out an editor 
buffer, compiling a program to produce an object segment, and 
outputting a file from a user program using language I/O facilities. 
The following is an example of a record quota overflow occurring while 
writing an editor buffer. This is a particularly dangerous problem 
for if it can not be corrected, the changes made to the text or source 
file will be lost. 

edm prog.plT 
Edit. 



w 

Error while processing in ring 0: 

record_quota_overflow condition by bound file system 1 3627 

referencing > udd>Ser pen t>P J Apple> prog.plT! 300^6 

Entry into lower ring was by 
>system_librar y_standard>edm | 50^7 
referencing hcs_$truncate_seg 
r .... level 2, . 

get_quota -wd 
quota = 2; used = 2 
r .... level 2, . 

list 

Segments = 3, Lengths = 2. 



re 


1 


xxxx 


r w 
r w 



1 


prog. pi 1 
xxxx.pll 



r .... level 2, . 



(1) This is normally the person or group through which funding has 
been arranged. For most users, this will be the User Accounts Office. 
Students in courses should contact their instructor. Users on the 
Student project, should contact the SIPB. 
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delete xxxx 

r .... level 2, . 

get_quota -wd ^ 
quota = 2; used = 1 
r .... level 2, . 

start 
q 



.... 



When the user tries to save his changes to the file "prog.pll", the 
error occurs. The error message indicates that the error occurred in 
a supervisor routine called from the editor program. 

The get quota command gives the current value of the quota and the 
number ""of records currently charged against it. The list command 
gives the lengths (see below) of the files in the directory as well as 
their names. The user then deletes the object segment "xxxx" to make 
room to write the file in the editor. (Note that information is not 
hPinff lost here, as the source file "xxxx.pll" can be recompiled to 
create the object segment once sufficient quota has been obtained.) 
The get quota command shows that a single record of storage has been 
freed up, and the start request causes the editor write operation to 
be restarted. Since he is finished editing, the user quits out of the 
editor. 

If the user then tried to compile the program, another record quota 
overflow would occur because with the file "prog.pll" successfully 
written, the number of records used is once again two. 

pll prog -table 
PL/I 

Error: record_quota__overflow condition by compile_entry I 62T 
Osystem library standard>bound_cg_) 
referencing >uddTSerpent>PJApple>prog!0 



.... 



level 2,. 



In this particular case, the user can do nothing to gain additional 
storage, except delete the source file xxxx.pll. If the file were of 
no use, the choice of deleting it would be acceptable; and the user 
could restart the compilation with the "start" command. If it were 
unacceptable, the user could only wait for additional storage. The 
problem would not be as critical as in the case above, as no 
information would be lost by logging out. 

The third context in wh.^ch a record quota overflow might occur is in r 
user program that writes output to a file. 
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filewriter 

Error: record_quota_overflow condition by open_uns__file$put_chars_un 
Osystem library_standard>bound_vfile_) 
referencTng >udd>Serpent>PJApple>output file!0 
r .... level 2, . 

Note: The list command normally will give the "length" of the 
segments listed. This is the apparent size of the segment as computed 
from the bit count. However, bit count can be inconsistent with the 
number of records used by the segment if the segment contains zero 
page(s) (see above), or if the bit count has never been set (which can 
occur for a file which was never closed or a data structure or common 
block overlaid on a segment). Continuing with the example above: 

get quota -wd 

quoTa = 3; records =3. 

• . . • . 

list 

Segments = 2, Lengths s M. 

re 3 test 

r w 1 test.fortran 



The get quota command shows 3 records now in use (an additional record 
filled In by completing the compilation); but the list command shows 
lengths totaling four records. If the "-records" option is supplied 
to the list command, the actual records used by the segment will be 
given. 

list -records 

Segments = 2, Records =3. 

2 test 

1 test.fortran 

I • • • • 

This is consistent with the results given by get_quota. The point is 
that when looking for segments to delete or move when reclaiming disk 
quota, the "-records" option should be used to obtain the correct disk 
usage for the segment. In addition, It cannot be assumed that a file 
is empty because its length is zero. Rather, it is empty only when 
its records used is zero. 
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LINKAGE ERROR 

This error will occur when a program tries to reference an external 
symbol, for example, an external program or PL/I external data, and 
the specified symbol is not found. If the source of the error can be 
determined, and the problem fixed, the program can be restarted. Note 
that it is possible to "fix" a linkage error in such a way as to cause 
another flavor of the same error to occur when the program is 
restarted. A little thought will prevent this from happening however. 

inere are iOur" suDv-jLoSoeo w* xj.iii\cie,e eiiS./«o. 

Segment Not Found 

It means that a segment with the specified reference name was not 
found anywhere in the user's search rules. For example, assume that 
procedure "prog" calls another program, "zzzz$aaaa", which for some 
reason cannot be found. 

prog 

Error: Linkage error by >udd>Serpent>PJAppie>progi 20 (line 3^) 
Referencing zzzz'aaaa. 
Segment not found, 
r .... level 2, . 

The basic approach for dealing with this error is to list the 
directories within which the program or data segment was thought to be 
in order to determine which of the following four cases apply. 

- the segment referenced really did not exist 

- the segment referenced exists, but its name was given 
incorrectly (e.g., misspelled), 

- an entry (segment or link) of the correct name exists within the 
search rules, but was ignored 

- the referenced segment exists in a directory not in the search 
rules. 

The typical user who is working alone, (i.e., not using programs in 
some "private" library) and is only using his own programs, standard 
system commands and subroutines will usually only have to consider the 
first two cases. Below is a further description of each case. 

a. The segment may not exist. For example, it may have never been 
created. A common problem for new users is forgetting to compile the 
program. Continuing with the above example: 
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list 

Segments = 3, Lengths = 3. 

re 1 prog 

r w 1 zzzz.fortran 

r w 1 prog.pll , 



• • • • 



level 2, . 



Notice that there are source and object segments for prog, but only a 
source segment for zzzz (zzzz.fortran). The cause of the problem 
then, is that there is no object segment named "zzzz" to.be found. 
Compiling the program (as shown below) will create such a segment; 
restarting execution will cause the search for the segment to be 
repeated, and this time found. 

fortran zzzz 

fortran 

r .... level 2, . 

list 

Segments = M, Lengths = 4. 

re 1 zzzz 

re 1 prog 

r w 1 zzzz.fortran 

r w 1 prog.pll 

r .... level 2, . 

start 
.... 

b. No segment of the designated name may exist. This can happen if 
the user is confused about the name of the segment. For example, if 
a PL/I program is called "subr" (i.e., subr is the label on the 
procedure statement) but the program resides in a segment of another 
name (e.g., subroutine), calling "subr" from another program will 
cause this error. This problem can be fixed by renaming (with the 
rename command) the segment (and the source segment) containing 
"subr". 

rename subroutine.** subr,== 
r .... level 2, . 

c. If the search rules have been stated as the user desires,, and 
there is in fact a segment of the correct name in one of the 
directories in the search rules, then the most likely cause of the 
error is that the user has no access to the segment. For example, a 
"list" might show 
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list -pn >udd>Serpent>PJApple 

Segments = 3, Lengths = M 

re 1 prog 
2 zzzz 
r w 1 prog.pll 

r .... level 2, . 

Mf^*-<^^ *-U^¥ fKA*-£» ^ c nri anne^tifi M'rp". "ru". Ptc . > listed fOT the 

segment zzzz. This problem should be corrected with as described in 
Section IIIB (Incorrect Access On Entry, etc.). 

The second cause of this problem is a link of the correct name which 
points to a non existent segment or a segment to which the user has no 
access. A non-existent segment can be caused by the segment having 
been moved or deleted or the target pathname being incorrect. This 
might appear In a listing of the directory as follows: 

list -pn >udd>Serpent>PJApple 
Segs=0;Msfs=0;Dirs=0;Links=1 . 
r .... level 2 , . 

list -pn >udd>Serpent>PJApple -link 

Links = 1 . 

zzzz > udd>Ser pen t>BDLucifer> zzzz 

r .... level 2, . 

initiate >udd>Serpent>PJApple>zzzz 
initiate: Entry not found, zzzz 
r .... level 2, . 

The first list command (listing segments) shows that there are no 
segments in the directory, but that there is one link. The second 
list command shows the link to a segment in another directory. The 
initiate command is used to determine the reason why the segment 
pointed to by the link was ignored in the search. Here it does not 
exist. If the target pathname is incorrect in that a directory is 
named incorrectly, the command error "Some directory in path specified 
does not exist." would be reported. If the problem is no access, the 
error would be "Incorrect access on entry." 

d. While a segment of the correct name may be known to exist, the 
directory containing it is not in the search rules. The current 
search rules may be listed with the "print_search_rules" command. 

print_search_rules 
initiated_segments 
referencing dir 
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working^dir 

>system_library_standarcl 

>system_library_unbundled 

>systein__library~1 

>system_library_tools 

>system library__auth_inaint 

r .... level 2, . 

list -pn >udd>Serpent>PJApple 

... 

Note that this is a common problem to users of packages such as BMD, 
IMSL, SSP, or the M.I.T. Calcomp subroutines. These programs are kept 
in directories outside of the normal search rules. (1) 

In general, when it has been determined that a segment to be 
referenced is outside of the search rules, one of three things can be 
done. The search rules can be adjusted to include the directory 
containing the segment; the segment may be initiated; or a link to 
the segment can be created. For example, assume that the segment in 
question is the IMSL subroutine eigrf. The search rules can be 
corrected with the "add_search_rules" command. (2) The problem could 
be resolved by: 

add_search_rules >libraries>imsl -after >system library unbundled 
r .... level 2, . ~ ~ 

print_search_rules 

initiated_segments 

referencing_dir 

working__dir 

>system_library_standard 

>system_library_unbundled 

>libraries>imsl 



.... 



r .... level 2, . 

Here, the print_search_rule command has been used to show the 
corrected search rules. This approach is useful when the missing 
segment is one of a collection of programs in the same directory 
(like a program library) whose other members are also likely to be 
used . 



(1) The documentation for such program libraries will usually specify 
how to make use of those routines. This advice should be followed. 

(2) In the example below, the new search rule is added after 
>system_library_unbundled rather than after working dir to avoid 
searching >libraries>IMSL every time a command or ""subroutine is 
referenced for the first time in the process. 



The segment may also be initiated. This is useful when there is only 
one program needed, and it is likely to be used only within the 
current process. 

initiate >libraries>imsl>eigrf 
r .... level 2, . 

A link to the program may also be created. This need only be done 
once, and will enable the program to be referenced without issuing 
additional commands at any time in the future provided that the 
QirecbOry Cunuaxuxng uuc xjinn. i cuiaxno v*x«^iixii v<n>- w*v,wi v,.. ■ v«->.x.w^. . — 
simplest way to ensure this is to place the link in the directory 
containing the calling program itself. > ♦ 

link >libraries>imsl>eigrf 
r .... level 2, . 

where eigrf 
>libraries>IMSL>eigrf 
r .... level 2, . 

The "where" command gives the pathname of the segment whose reference 
name is given. That is the segment that will be invoked if a program 
of the name given is called. It has been used here to verify that the 
link was successful. 

External Symbol Not Found 

This means that a segment matching the reference name specified was 
found, but that the (perhaps implicitly) specified entry point was 
not. 

prog 

Error: Linkage error by >udd>Serpent>PJApple>prog ! 3^ (line 38) 

referencing xxxxlaaaa 

External symbol not found. 

r .... leve] 2, . 

This means that the segment xxxx was found, but the external entry 
point (symbol) "aaaa" was not found in the segment. In addition to 
trivial naming and typing mistakes, one of the more frequent causes 
for the error is that the program resides in a segment with a name 
different from the one used on the procedure statement of the program. 
The program is then called using the segment name. 
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edm test.pH 

Segment not found. 

Input. 

tester: procedure (a); 

del a float binary(27); 

a = a «» 2; 
end; 

Edit, 
w 

q 

r . . . . 

pll test -table 
PL/I 

» « • • • 

test 

Error: Linkage error by >udd>Serpent>PJApple>call_test 1 5^< (line 2H) 

referencing test I test 

External symbol not found. 

r .... level 2, . 

This problem can be eliminated only by changing the name on the 
procedure statement from tester to test and recompiling the program. 

Linkage Section Not Found 

This means that a segment of the specified name was found, but that 
the segment did not have a linkage section (i.e., it is not an object 
segment) . 

prog 

Error: Linkage error by >udd>Serpent>PJApple>prog! ^3 (line ^2) 

referencing xxxxiaaaa 

Linkage section not found. 

r .... level 2, . 

This may occur if the name of a data or test segment was specified 
instead of the name of an actual compiled program. For example, a 
common problem is a source segment which is given the name of its 
object segment. 
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list 

Segments = 4, Lengths = 4. 



r w 


1 


xxxx 
xxxx.pll 


re 


1 


prog 


r w 


1 


prog.pll 



r .... level 2, . 

The list command shows the two names on the source file "xxxx.pll". 
When "xxxx" was referenced from the program, it was this segment that 
was found, but it was not a valid object segment. 

To recover from this particular error, the name must be deleted from 
the segment, aird the text compiled into the object program to be 
called. The program can then be restarted. 

delete_name xxxx 
r .... level 2, . 

pll xxxx 

PL/I 

r .... level 2, . 

start 



There is No Room to Make Requested Allocation 

This means that the size of a named external data area exceeded the 
system limit of 255K words. Examples of such areas are named common 
blocks in FORTRAN and external symbols given reference names (names 
containing a "$") in PL/I. For example 

nospace: procedure; 

declare bigarea$ (300000) external fixed binary; 

... 

bigarea$ (1) = ... ; 

... 
end; 

Executing the above program would produced the following error: 
nospace 

Error: Linkage error by >udd>Serpent>PJApple>nospace 1 1 1 (line ^ 

referencing bigareal 

(with a create-if-not-found link) 

There is no room to make requested allocation, 

r .... level 2, . 



When such an error occurs in a PL/I program, the user should examine 

the declaration of the external symbol and calculate the size. If it 

is a structure containing elements each smaller than the limit, the 
structure can be broken up. For example 

declare 

1 extstruc$ external, 
2 a (100000) fixed bin, 
2 b (100000) float bin, 
2 c (100000) float bin(63); 

would occupy a total of 400,000 words of storage. Member a uses one 
word per element; b, a single precision real value, uses one word per 
element; and c, a double precision real vilue, uses two words per 
element. It can be broken up into two or three small structures: 

declare 

1 extstruc1$ external, 

2 a (100000) fixed binary, 
1 extstruc2$ external, 

2 b (100000) float binary, 
1 extstruc3$ external, 

2 c (100000) fixed binary; 

If the symbol being created is one large array, then the programmer 
should attempt to reduce the size of the array needed. If such a 
reduction is not possible, it may be possible to simulate the array as 
an array of pointers to cross sections of the original array. 

declare 

array$ (3,100000) external fixed binary; 

would cause the error described here. This could be replaced by 

declare 

array (100000) fixed binary based, 
arrp (3) pointer initial 

(addr (array1$), addr (array2$), addr (array3$)), 
(array1$, array2$, array3$) (100000) external fixed binary; 

with the program edited to replace all references to 

array (x, y) by arrp (x) -> array (y) 

Similar problems occur in FORTRAN when very large common blocks are 
used. As in PL/I, there are two cases: when there are many small 
members of the common block, and when there is one very big member. 
In the first case, the problem can again be dealt with by splitting up 
the common block. 
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common /data/ a(IOOOOO), b(IOOOOO), c(IOOOOO) 



becomes 



common 
common 



/datal/ a(IOOOOO), b(IOOOOO) 
/data2/ c (100000) 



In the second case, that of one very large member, there is no metl 
to get around the problem that is particularly efficient. The b* 



method 
lest 
that'can be done is to write a function that references cross sections 
of the array defined in different common 



common array (3,100000) 



becomes 



function array (x, y) 

common /datal/ arrayl (100000) 

common /data2/ array2 (100000) 

common /dataS/ array3 (100000) 

go to (1, 2, 3) X 

1 return (arrayl (y)) 

2 return (array2 (y)) 

3 return (array3 (y)) 
end 



SEGMENT FAULT 

This error means that the program has addressed a non-existent 
segment. What has happened is that an address value (pointer, entry, 
or label) contains an invalid segment number. There are two general 
causes: using an uninitialized address datum, and using an address 
value designating a segment after that segment has been deleted. 

A deleted segment may be referenced under the following 

circumstances. If the program was, at the time of being deleted, 

still active (its execution suspended by a quit signal or error 
condition) . 

prog 

Error: Attempt to divide by zero at >udd>Serpent>PJApple>prog!2i 

(line 12). 
System handler for error returns to command level, 
r .... level 2, . 



delete prog 

r .... level 2, . 



^'^6 



release 

Error: Segment-fault error by unwind_stack_| 120 

(>system_library_1>bound_sss_active_) 

(while in pll operator cp csa) 

referencing 36712 ~ 

There was an attempt to use an invalid segment number. 

r .... level 2, . 

Or if the segment is an input or output file that was not closed prior 
to deleting the segment. 



(quit) 



prog 

QUIT 

r .... level 2, . 

delete output file 
r .... level ^, . 

release 

r » • • « 

prog 

Error: Segment-fault error by open uns_file$put_chars_uns_file 1 1036 

(>system_library_standard>bound_vfiTe_) ~ 

referencing 3^510 

There was an attempt to use an invalid segment number. 

r .... level 2,. 

An uninitialized address value is usually caused by forgetting to 
initialize the corresponding variable, (1) 

prog 

Error: Segment-fault error by >udd>Serpent>PJApple>prog ! 327 

(line ^3) referencing 2349127 

There was an attempt to use an invalid segment number, 

r .... level 2, . 

probe 

Condition segfault raised at line 43 of prog. 



(1) This can also cause any of the other bad address problems 
described under other errors. An uninitialized pointer may cause a 
worthless value to be displayed for a variable qualified by the 
pointer or for the pointer itself. (Most uninitialized automatic 
pointers point into the stack). < 
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source 

p -> data = 3; 
value p 
23^9127 

• • • 

In FORTRAN, address data problems may occur as well. One cause is 
passing an array argument to a FORTRAN subroutine whose corresponding 
parameter is not dimensioned. When the program references this 
parameter with subscripts, FORTRAN treats the parameter as an entry 
value. For example, executing a program of the following form 

subroutine mattran (arrin, arrout) 
dimension arrout(4,^) 

arrout (i,j) = arrin (j,i) 
• • • 
end 

could cause an error of the form 

mattran test 

Error: Segment-fault error by >udd>Serpent>PJApple>mattran! 1^3 

(line 12) referencing 3271756 

There has been an attempt to use an invalid segment number. 

r .... level 2, . 

probe 

Condition segfault raised at line 12 of mattran. 

source 

arrout (i,j) = arrin (j,i) 
value i; value j 

1 

1 
value arrin (i,j) 

Error: Segment- fault error by print_referencel 2373 
(>system_library standard>bound_probe_! 1^517) 
referencing 3271756 
There has been an attempt to use an invalid segment number. 

r .... level 3,. 

pi 

symbol arrin 

entry variable parameter 

... 

Here, the subroutine mattran has been called from mattran_test . A 
segment fault error occurs on line 12, and probfe is invoked to look 
for the cause of the problem. The "source" request gives the text o 
the statement in which the error occurred; "value" requests enable 
the user to determine with what variable the program is having 
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difficulty. The error reoccurs when the value of "arrin (i i)»' is 
displayed, indicating that "arrin" is the problem/ The 
program_interrupt (pi) command is used to probe, and the "symbol" 
requests used to display the attributes of the variable. The output 
shows that it is an entry variable and not an array at all. 

Another cause would be passing too few arguments to a subroutine In 
this case, referencing a parameter for which there is no corresponding 
argument may cause a segfault or other addressing error. 

NO EXECUTE PERMISSION 

This means that the user»s process is attempting to execute a segment 
to which it does not have execute access. Upon getting this error, 
the user should attempt to set access (or have the access set for him 
by the owner of the segment) to read and execute. (1) and if 
successful, restart the program. ' ' 

prog 

Error: no execute permission condition by command processor 1522 
(>system_lTbrary_1>bound_command_loop ) ~ ~ 

referencing >udd>Serpent>PJApple>progT3 
r .... level 2, . 

set_acl prog re 
! «... Jievej. ci J % 

start 
... 

This can occur if the access has been set incorrectly on the segment 
For instance, if a "set^acl *» rw" command has been issued in th^ 

nni^n^i'^n^K '''' /^ 1^^ "^^'* ^^^ Created the object segment before 
compiling by using the create command. 



The error can also occur when an uninitialized label or entry variable 
is referenced. This particular case can be distinguished fr. 
others by the identity of the segment being referenced. If it 



is referenced. This particular case can be distinguished from the 
others by the identity of the segment being referenced If it is one 

"nina"^''i'i'^K^^ ^'^^?^^^N^^^^ ^^^^^^ (e.g., in the example above. 



"prog" is being called), then the probleS is probably a simple access 
Vl?^\v!''' 11^ other hand, if the segment , is^ dataV ?ext segment? 
etc., then the problem is probably an uninitialized address datum. 



(1) At least "re" access is necessary for an object segment; 
alone will not suffice. Write access is not advisable. 



»»r»»» 
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NO READ/WRITE PERMISSION 

These mean that the process lacks the access required to read or 
write the segment mentioned in the error message. 

prog 

Error: no write permission condition by prog!^12 (line 101) 
referencing >uddySerpent>PJApple>data_seg 12 

r .... level 2, . 

The simplest cause is having failed to set or obtain the necessary 
access. As with a no execute^permission error above, the user may 
attempt to set the required access, and then restart the program. 

This problem may also be caused by bad address data. This case may be 
distinguished from a simple access error as also given above. 

NOT IN READ/EXECUTE/WRITE/CALL BRACKET 

This means that an attempt has been made to reference an inner ring 
segment. The cause is almost always bad address aata. 

prog3 

Error: not_in_write_bracket condition by prog|26 (line 5) 
referencing dseglO 

level 2, . 



.... 



The identity of the segment being referenced can often give a clue to 
the variable whose value is bad. A reference to dseg, as occurred 
here, usually indicates that a packed pointer (a pointer value 
declared unaligned) is uninitialized. A reference to the stack or 
linkage section, is strong evidence that an automatic or static, 
respectively, aligned pointer, label or entry value has not been 
assigned a value. 

FAULT TAG 1 /FAULT TAG 3 

This means that an addressing modification fault has occurred while 
attempting to indirect through a pointer. Since these modifiers never 
appear in PL/I pointer datums, the problem is usually uninitialized 
address data. 

prog 

Error: fault tag_1 by >udd>Serpent>PJApple>progl 14 (line 8) 
referencing slack^M 13320 (in process dir) 
Ascii data where pointer expected, 
level 2 , . 



.... 
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The fact that the program was referencing some data in stack_^ at the 
time of the error indicates that the bad pointer was an automatic 
value. If the program had been referencing "combined linkage_section 
^.00, the bad pointer would be a static value. The address modifier 
may also be encountered when trying to execute data. In such a case 
the error message will indicate that the segment causing the error is 
a data segment such as the stack or the combined linkage section. 

The error fault_tag_1 is often caused by an uninitialized pointer 
occupying space previously filled with ASCII data (hence the second 
part of the error message). 

ILLEGAL MODIFIER 

This means that an illegal address modifier has been used. It may 
appear in a pointer value or in data being executed as regular 
instructions. 

prog 

Error: illegal_modifier condition by >udd>Serpent>PJApple>prog! iJ^ 
(Line 18) referencing stack_4!0 (in process dir) 

Possible illegal modifier in indirect chain or uninitialized pointer 
r .... level 2, . 

The causes of this error are identical to those of a fault_tag 1/3 
error. It is also not restartable. The problem must be corrected 
before the program can be run again. 

ATTEMPT TO REFERENCE THROUGH A NULL POINTER 

This means that a null pointer has been used as a locator value 
qualifying a reference to a based variable. It usually indicates a 
logical bug in the program. 

prog 

Error: Attempt by >udd>Serpent>PJApple>prog!57 (line 23) 
to reference through null pointer 
r .... level 2, . 

The programmer should carefully examine his or her program to 
determine how the locator (pointer or offset) value could have a null 
value at the location in which the error occurred. The variable may 
not be referenced with an explicit qualifier 

data instead of pi -> data 

In this case, the default qualifier e.g., based, (p) is used, and 
its value should be checked. 
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Condition simfault_000001 raised at line 23 of prog. 

source 

result = based_num +4; 
symbol based num 

fixed binaryTl?) aligned based (p) 
Declared in prog, 
value p 

null 
• • ■ 

This error may also occur for controlled as well as based data, if a 
controlled variable is referenced before it is allocated. 

SIMFAULT NNNNNN 

This means that the programmer has attempted to use a pointer with a 
segment number of -1 and an octal offset of NNNNNN. The cause is use 
of uninitialized address data. 

Note- a pointer with segment number -1 and offset 000001 is a null 
pointer. " In such a case, the error message reaas "ALtempL tu 
reference through a null pointer" as described above. The condition 
simfault 000001 is signalled explicitly only when the pointer value is 
not entirely a valid null pointer (for example, it has a non-zero bit 
offset) . 

ILLEGAL MACHINE OPERATION 

This means that there has been an attempt to execute an undefined 
machine instruction. 

prog 

Error: Illegal machine operation by progl^ 
Current instruction is: 

000004 000000000000 .... 
r .... level 2,. 

The two most common causes of this error are: branching to a 
nonexistent element of a constant label array, or using an 
uninitialized label or entry value. The segment in which the error 
occurs may be used to distinguish the two cases. In the former, the 
segment will be one of those in use (in the example above prog); in 
the later, it will be a data segment (stack or linkage section) or 
some other unexpected segment. 
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STORAGE CONDITION 



There are two causes of this error. First, the user has attempted to 
allocate more based or controlled storage than is available in the 
system area. This will be acompanied by the message that system 
storage is full. 

prog 

Error: storage condition by >udd>Serpent>PJApple>prog 1 15^ (line 52) 
System storage for based and controlled variables is full, 
system handler for error returns to command level 
r .... level 2, . 

The programmer should inspect the declaration of the variable being 
allocated. The system cannot allocate more than 262, ^^^ words of 
storage for any one variable. If the variable being allocated has an 
expression for a string length or array bound, the value of those 
expressions should be checked. Often they may involve undefined 
values. If all allocations are relatively small (e.g., hundreds or 
low thousands of words) , the problem may be that the allocation is 
being repeated too many times. A check should be made for an infinite 
loop involving the allocation. 

Second, and most common, is that the stack has overflowed. This error 
will be accompanied by the message that the stack has been extended. 

prog 

Error: storage condition by >udd>Serpent>PJApple>prog! 166 (line 58) 
Attempt to reference beyond end of stack. Stack has been extended, 
system handler for error returns to command level 
r .... level 2, . 

This error will first occur when more than 6ilK words of stack space 
are required or when a reference is made past the first 6ilK of stack. 
The stack is extended to the next il8K boundary. Depending on the 
cause for extending the stack, it may be permissible to restart the 
program with the start command. Subsequent storage conditions may 
occur if additional storage is required/referenced, and the stack will 
be extended in i48K increments up to a maximum length of 208K Anv 
attempt to use more than that will cause a fatal process error (see 

L' C X \J W / # 

One cause of this error is that the program is recursing too deeply 

(or infinitely). This case can be verified by examining the frame 

number, the second of the two numbers in the in ready message level 
information: 

r .... level .,137 
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A value in the hundreds is a certain sign of trouble. (1) The 
cummulative automatic storage requirements for a moderately recursive 
program (or set of programs) may also be too great. The required 
storage can be determined from a compilation listing produced with the 
"-map" option (under the heading "storage requirements for the 
program"). If the storage requirements will not exceed the maximum of 
208K, it is safe to restart the program. I 

An excessively large stack frame size may also arise if there are 
automatic variables declared with expression llength or array bounds, 

-.-J A.I , ^ ^ i ^^ ^ ».^ /<£v.«£>M^£. •.•^•tM•i4■•(f^1■■•9^rl tioliiAc fl r>nmmrvn mi S^ ak<P 

anU Lfie CAJJI Caoxuuo I CICI euv^e un xnx t< j.ajL x<.€vi WWJ.V1V-W*. .1 ^-v .^ -' '^•- 

is to make use of another automatic variable in such an expression 
whether or not that variable has an initial value specified. For 
example, a program containing the declaration 

decl are 

array (array_dim) fixed binary, 
array_dim fixed binary automatic; 



could cause the error message appearing above, 
might continue as follows: 



A debugging session 



probe 

Condition storage raised at line 58 of prog. 

source 

call subr (...); 

Here probe has been used to determine where the error occurred. The 
source request shows that the error occurred while trying to call 
another subroutine. The reason that the error occurs at this point is 
that until the subroutine is called (creating a new frame for the 
subroutine) the stack is not actually extended. So the programmer 
examines the program for abnormally sized variables: 

symbol array 

fixed binary(17,0) aligned automatic dimension(71902) 

Declared in prog. 

The symbol request gives the evaluated dimensions for the array, 
showing it to be extremely large. (The error could appear in the same 
fashion if the large bounds were intended.) 

Another cause is subscripting an automatic array with a value far out 
of bounds. This can be detected in PL/I programs by putting a 
subscriptrange prefix on the procedure statement. 

(subscriptrange) : 
prog: procedure; 



(1) In fact, a value in excess of 30 to ^0 is uncommon, and 

a<^m^w«m11«> W^ik M<%«vnwr4#vj4 ** m n «4/Tm fs 4^ ir\v f\)r\^ tarn tf 



can 
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end; 
-subscriptrange" control argument ' ^^^P^^^ng the program with 



the 



fortran zzzz -table -subscriptrange 



A similar cause 



is 



is, the use of the 



substr builtin function^ith out nf^^ ^^^""^'^ that .., ^ne use n 



A final cause is 
with star (expr 
as the return arg 
uninitialized c 
condition can be 
before the call 
by a storage cond 
case, there wil 
executing at the 



the invocation of a funrf^^n «.u . 
ession) extents. If the ho. /^^^ returns a 
ument are bad, or if ^ h S"^ °^ ^^ a^^r-ay dev 
haracter varying strfn. ^""^^^"^ express! 
raised after the called ?Lctf "\^"^"-^» a s 
ing program has resumed execution '^2^ • '^'"^"^^ 
ition occurring in a svJln, ' ^^^^ ^^ ind 

1 be no other informatfnn ^^^"'^"t. if this i 
time of the error """ ^^ ^° ^^^t user progr 



value 
eloped 
on or 
torage 
f but 
icated 
s the 
am was 



OUT OF BOUriDR PyrfT 



This 




«-^ue specified but 'has 
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ILLEGAL PROCEDURE 



This occurs when the hardware is requested to perform an illegal 
operation. The most usual cause is uninitialized decimal data. 



baddec 

Error: illegal^procedure condition by >udd>Serpent>PJApple>baddec 
(line 5) referencing stack_M|3320 (in process dir) 

I ... xevei d, . 

probe 

Condition illegal_procedure raised at line 5 of baddec. 

source 

dv = dv + 1 ; 
symbol dv 

fixed decimal(7,0) aligned automatic 
Declared in baddec. 
value dv 

Error: illegal_procedure condition by arithmetic to ascii ill? 
(>system_library_standard>bound_trace ) "" "" ""' 

referencing pl1_operators 110 ~ 

r .... level 3,. 

release -all 
• .... 

Here probe has been used to show the source of the line at which the 
error occurred. It contains a reference to a decimal variable. This 
is sufficient evidence to believe that the problem is uninitialized 
decimal data. Displaying the value of the variable will cause the 
same error again, confirming the diagnosis of the problem. (The 
release command, with the -all option, is used to flush execution of 
probe, suspended by the second occurrence of the error, and baddec 
suspended by the first.) ' 

Other, less likely, causes of the same error are: transfering to an 
element of a label array outside of the bounds of the label array and 
referencing uninitialized label or entry variables. In the former 
case, the location of the error will often be listed as the first line 
of the program; the line from which the condition is signalled will 
not be available. In the latter case, the location of the error will 
usually be in some unexpected segment. 
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CONVERSION 

This means that an error has occurred in the conversion of a character 
string to some other data type. This condition will occur in 
conversion to an arithmetic value if the string is not a correctly 
formed number. It will occur in conversion to a bit string if the 
source character string contains characters other that "1" or "0". 

badconv 

Error: conversion condition by >udd>Serpent>PJApple>badconv !22 
(line 6 onsource = "one", onchar = "o" 
Illegal character follows a numeric field, 
system handler for error returns to command level 
r .... level 2, . 

The error message gives, in addition to the location at which the 
error occurred, the values of the PL/I builtin functions, onsource and 
onchar. Onsource represents the character string being converted; 
onchar is the (first) character in the string which is invalid for the 
conversion. 

This error may arise during implicit or explicit conversions among 

variables (or the results of expressions) in the program, or during 

execution of a get statement when the input is converted to an 
arithmetic or bit value. 

SIZE 

This condition has three causes. It will occur when the value 
assigned to a fixed point datum exceeds the precision of the target — 
for example, assigning the value 9999 to a fixed binary(3) datum. The 
error will occur in this way only only if size checking was enabled 
for the statement in which the assignment was performed by a size 
prefix on the statement or the procedure statement. Second, it will 
occur during picture controlled conversion, if the target field is too 
small to hold the value being converted. Again size checking must be 
enabled. Third, it will occur during a put list or put data 
statement, when the value stored exceeds the precision declared for 
the variable, or during a put edit statement, if the output field 
cannot hold the value being output. Size checking is always enabled 
for put statements. 

size^err 

Error: size condition by >udd>Serpent>PJApple>size_err| 136 (line ^^) 

Precision of target is insufficient for number of integral 

digits assigned to it. 

System handler for error returns to command level 

r .... level 2, , 
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The user should be aware of a side effect of a size condition raised 
while executing a put statement. A common debugging technique is to 
include an error on unit within the program that dumps all the 
variables: 

on error begin; 

put data; 
end; 

If a size condition occurred, invoking the on unit, the put data 
statement within the on unit will cause another size condition to ue 
signalled when formating the variable for which the condition was 
originally signalled. The on unit will be invoked a second time, and 
the size condition signalled yet another time, and so on, ad 
infinitum, eventually leading to a storage condition or fatal process 
error. 

ERROR CONDITION 

An error condition will be reported when an erroneous state arises in 
¥v.^ n».n<Tram. and there is no soecific condition for that state. For 
example^ this includes use of mathematical builtin functions with 
arguments that are out of range. 

The following program is used to illustrate a typical situation in 
which the error condition will be raised. 

bigexp: procedure; 

del sysprint file; 

put list (exp (23^5)); put skip; 
end; 

Executing the program will cause the condition to be signaled. The 
system on unit gives the rea^ion for the specific cause of the problem, 
and states a fixup to be taken if the program is restarted. 

bigexp 

Error: error condition by >udd>Serpent>PJApple>bigexpi 53 (line 3 

exp(x), X > 88.028, not allowed 
Type ""start"" to set result = . 170141 l8e+39 
r .... level 2, . 

start 
1.701e4-038 



.... 



After receiving the error, the programmer may decide that the standard 
fixup is acceptable, and restart the program as has been shown above. 
Notice that the program proceeds normally to output the result as sel 
by the action of the system on unit. 
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SUBSCRTPTRANGE 



when the progra.^lr^'hir sjecified'tha? sllscTilTllL^i^n, °"'' 
performed (by placing a suhs^rinf^^nL subscript range checking be 

procedure statement, or compiling TTollrL '"'''' °" ' '^'^ 

IrTlZlllT'irT^' -8 — t? Su'ch^he'c° g"is''usff:T when\h": 
are unexplainable storage, out of bounds, or fatal process"errors. 

subrange 

(line>)!"'"°'"^''^'"'"^' condition by >udd>Serpent>PJApple>subrange! 17 
A subscript value has exceeded array bounds, 
system handler for error returns to command level 

• • • • • i6vei 2 , • 

probe 

Condition subscriptrange raised at line 7 of subrance. 

array (i) = i; 
value i 

5 
symbol array 

Decl«reH"?n^^^I'°' ^^^^"^^ automatic dimension(i.) 
ueciared m subrange. 

• • • 

err:r.\\rpr^^Sm%renti;;^^^;^gr^?f ZTelllT.- th"^°" '''''''''' ''^ 

it With the dimensJonrfor the arrai%'s%'?ven%rJr °' K'"!' '°'"^'''' 
Here the subscript, i is onw I f]lt^ Ll^^ ^^"''"^ request. 

indicates a logical' big, Ipecificallv tL% ^h°"' °' ""^'- ^'^^ 
constraining the value of the i■,?;^^;^^i ^^ ,^^^ program is not 
the value of the subscrfp? were grossli'our°^f'"^^- 'Alternatively, if 
-72301292), this would be an indication that th/nr^Ki ^*^°'" tl'""^^^' 
subscript was uninitialized or a^^ifniS *u , Problem was that the 
an) uninitialized Variable. ^'^^«"^^ ^he value of some (function of 

J?p! '?::^^'J2? !^y ^1=° ^^^^^ when a function which 



o r 1 1 r« r» e 



e array returned do 

For 
s 



nn^^l^tt^i:. ^1"^ ^'''1^^ ^^ "^^^» 3"^ the bounds of the 
not match the bounds of the arrav tn u^y^i^t •«. : 

example, assume that data has dimension ?J^ L'f. l^ assigned. Fo 
an array with dimension (5). Then ^^ array^fun return 

data r array^fun (...); 

will cause a subscriptrange condition to be signalled. 
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STRINGRANGE 

This means that a substring of a character or bit string value as 
specified by the substr builtin function is not completely contained 
within the string value. Given the reference 

substr (s, i, j) 

the error implies that one of two conditions is true: that i, 
soecifying the starting position of the substring, is less than one or 
greater tnan line curreni; lengm ui one owrxue, wi wnau j, «^x-^-.. ^---o 
the length of the substring, is less than zero or greater than the 
number of positions included in that portion of the string from 
position i to the end. 

The stringrange condition will only be raised if the programmer has 
compiled the program with a stringrange condition prefix on the 
procedure statement or on the statement which uses the substr built-in 
function. 

stringrange 






Error: stringrange condition Dy >uaa->berpenL?rjftppie^5tringr arj^c 
dine'?). A substring specified by substr is not completely 
contained in the first argument. System handler for condition 
returns to command level, 
r .... level 2,. 

probe 

Condition stringrange raised at line 7 of stringrange. 

source 

substr (str, 1, i) = "a'»; 

value i 
-1 
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FIXEDOVERFLOW, OVERFLOW, UNDERFLOW 

?h!^n. Jr-"*^ i"?^''^^^ ul^^^^ ^^^ ^^^"^^ °^ ^ computation has exceeded 

the precision of the machine. Fixedoverflow applies to fixed point 

computations and indicates that the result is too large. It should 
not be restarted. 

folf 

Fixed point overflow by >udd>Serpent>PJApple>folf 1 1^3 (line 27) 
System handler for error returns to command level 
r .... level 2, . 

Overflow applies to floating point computations, and indicates that 
the result is too large. It should not be restarted. 

olf 

Error: Exponent overflow by >udd>Serpent>PJApple>olf | 160 (line 33) 
System handler for condition returns to command level 
r .... level 2, . 

Underflow applys to floating point computations, and indicates that 
the result is too small. The program is automatically restarted with 
the result of the computation set to 0. ^ 

unfl 

Error: Exponent underflow by >udd>Serpent>PJApple>unfl | 16? (line 39) 
i .... 

Notice that after an underflow condition the system does not enter a 
new command level, but instead continues with the program. Here it 
has terminated normally, returning to command level 1. 
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PROGRAM INTERRUPT 

The program Interrupt command is used to reenter a command subsystem 
such as edm or probe after an error condition or quit signal. The 
command signals the program interrupt condition which is trapped by 
the subsystem. If the user mistakenly issues a program interrupt 
command to reenter a subsystem that does not handle the condition, or 
when there is no subsystem active, the condition will be reported as 
an error at command level. 

program^interrupt 



Error 
Osystem 



: program_interrupt condition by program_interrupt 171 
tem library_standard>bound_command_env_) 



r .... level 2, . 

If there is no subsystem active, the user should issue a release 
command to flush the program interrupt condition. If the user is 
trying to reenter a substem Ihat does not handle program_interrupt, he 
should issue a release command to flush the program__interrupt and then 
a start command to reenter the subsystem. (Normally, however, a 
subsystem may be reentered by a start command only if it was suspended 
by a quit signal.) 
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SECTION V 
FATAL PROCESS ERRORS 



In general, a fatal process error occurs when the system detects a 
condition such that the process is not able to continue running. (In 
particular, the system default on unit cannot be executed to interpret 
the cause of the error.) The action taken in this case is to 
terminate the process in which the error occurred and to create a new 
process for the user. Because it is a new process, there is no 
information available about the programs that were running when the 
error occurred, the value of program variables, etc. The only clue as 
to the cause of the error is the error message. 

The single most common form of a fatal process error is an out of 
bounds error on the stack. The causes are the same as for a storage 
condition (see above) arising on the stack. The message that is 
generated by the system designates that a fatal error has occurred, 
and then gives a error message indicating a more specific problem. 

Fatal error. Process has terminated. Out of bounds fault on user's 
stack. New process created. 

In the event of this kind of fatal process error, it is advisable for 
the user to recompile his program with subscriptrange and stringrange 
checking enabled and try the program again. If a stringrange or 
subscriptrange condition then occurs instead of the fatal process 
error, then it is likely that new error is the source of the problems. 

If the fatal process error recurs despite the checks enabled, then the 
cause of the problem can be just about anything. It is recommended 
that the user check his access to all programs and files that he is 
using to insure proper access. He should also check for the possible 
causes of a segment fault error. Finally, calls to system programs 
should be checked to see if they conform to all documented 
conventions. Should these checks fail to turn up a clue. He should 
use the probe command to set breakpoints at various strategic points 
in his program to isolate the point at which the fatal process error 
is occurring. Often the process will have to be repeated with 
additional breaks set until the location is narrowed down to a single 
statement. 
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There are several other kinds of fatal process errors that the user 
may see. They include: 

No unclaimed signal handler specified for this Pr^^^ss. 

This means that no default on unit could be found. The 
possible causes include subscript and stringrange errors, and 
the use of uninitialized address data. (See above and the 
previous section.) 

Fault in signaller by user's process. ^^ ^^^^ condition 

This indicates T^ne presence ui « vci jr s.oint/j.e« >,..>,. u -i^ 

and probably involves more than one cause. The user should 
apply the methods of described for the other errors and hope 
for the best. 

""IJ.fs'^mranr^'thrt'HSe^se?'^ process was unable to perform an 
input or output operation at a crucial point. For example, 
writing out an error message. This indicates that the I/O 
attachments for the user^input, user_output, error output and 
user i/o I/O switches are in an untenable state. The user 
should consider the kinds of operations that he performed 
prior to the fatal error, and determine ii tney eunxormcvi o^. 
documentation. 

Process terminated because of system defined error condition. 
This is a catch all message. Again, the user should try the 
methods described above. 

The reader should recall the comments about errors that vanish after a 
new process is created made in the introductory remarks to section 
IV. They apply to a fatal process error as well. 
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TYMNET DATA COMMUNICATIONS NETWORK 
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THE TYMNET NETWORK 



Assignment of TYMNET user id's and passwords contact 

Lacy Johnson 
Honeywell LISD 
Multics Computer Center 
Box 6000 Mail Station K40 
Phoenix, AZ 85005 
Phone: (602) 249-7303 HVN 341-7'i03 



LOCAL LINES 



D) a "help TYMNET_lines" to obtain a list of TYMNET dial-up lines 
ii the major cities serviced by TYMNET. 



COST 



TVMNET charges $7.50 per connect hour which will be passed on to 
the appropriate cost center, ^ 
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THE TYMNET NETWORK 



SUPPORTED TERMINAL 



TYMNET supports a wide variety of terminal types. Each terminal 
type has an identifying character which must be sent to TYMNET 
when you first log in to establish the transmission 
^v^Qi-a/^i-^ari 5?t-.i ns of the terminal. 



IDENTIFIER 



TERMINAL 



REMARKS 





Speed 


Baud 


Type 






(CDS 


rate 






b 


15 


150 


TermiNet-300 

TTY-37 

Hazeltine 

Exectport 


Full Duplex, 
odd parity 


d 


10 


110 


TTY 33/35 
TermiNet-300 


Full Duplex 


a 


30 


300 


TermiNet-300 


For thermal printer 


(RECOMMENDED) 






Execuport 
Texas Inst. 
CSC 
Hazeltine CRT 


terminals, a delay 
of N+6 or 7 
character times 
is used. 


carrigae 


15 


13^.5 


Date] 


Multics only accepts 


return 






IBM ;'7^1 


EBCDIC terminals 
through TYMNET. 



Only 300 and 13^.5 baud lines 
through the TYMNET network. 



are available on Multics for access 
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LOGGING INTO TYMNET 



1. Turn on the terminal and coupler. 

2. If the terminal has adjustable data transmission speeds, set 
the terminal to 30 cps. This is to handle TYMNET'S initial 
message. Lower settings give a garbled message during login. 

3. If you are using a terminal that has an Auto Linefeed switch 
(such as the TermiNet 300) , turn it off during the initial 
login procedure with TYMNET. Once you have made contact with 
Multics you may turn it back On. 

4. Dial the TYMNET phone number and wait for the high-pitched 
tone. (If the tone sounds weak or raspy, hang up and re-dial 
to obtain a better line). 

5. Place the telephone handset in the coupler or d<^press the 
"DATA" button if using a 1,03A or 113A dataset. 

6. The following message will be sent to your terminal at 10 
cps: PLEASE TYPE YOUR TERMINAL IDENTIFIER 

7. Set your terminal to the desired speed (if necessary), and 
type the appropriate letter or CR (carriage return). 

8. TYMNET will then send: -XXXX-YY— PLEASE LOG IN: where: 
XXXX is the remote access node number, and YY is the port on 
the node to which your terminal is connected. 

^_. , *w^ ...«j v-wc>-«. ivi one yi cocijuc Oi une netwoTK 

supervisor (which controls the Tymsat you have called) by 

typing a single CR. If the supervisor is in control, the 
following prompt will appear: USER NAME: 
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10. You may need the following control characters before entering 
your user name: 

a) control-H notifies TYMNET not to echo characters 

b) control-X to be used if you plan to input data from 

paper tape, cassette tape, or any other 
non-keyboard device. T'fMNET must be able to 
start and stop data entry. For this, 
control-Q starts the device and control-S 
stops the device. 

c) control-P. to be used if your terminal can only accept 

even parity. 

11. After receiving "PLEASE LOG IN:" or "USER NAME:" enter your 
TYMNET user id (preceded by control characters if necessary), 
followed by a CR. (user id may be in upper OR lower case). 

12. TYMNET will then prompt you for your password: PASSWORD: 

13. Respond by typing your password(in upper or lower case), 
followed by a CR. NOTE ; If you want to eliminate the prompt 
"PASSWORD:", enter your TYMNET user id, a semi-colon( ; ) , and 
the password followed by a CR.(THIS MAY NOT WORK FOR 
NON-ASCII TERMINALS) 

14. You should then receive either a semi-colon( ; ) or the 
following: P nn (which indicates the port number of the 
TYCOM connected to Multics) HOST IS ONLINE 

15. From here on, the login procedure is exactly as if you were 
dialing directly into Multics. 

16. When you logout from Multics, TYMNET will respond: 

CP DISCONNECTS DROPPED BY HOST SYSTEM 

PLEASE LOGIN: (at this point you may hang up the phone) 
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TYMNET PROBLEM RESPONSES 



ALL PORTS BUSY All available Multic3 TYMNET ports are in use 

at the transmission speed you have requested. 
Try again later or try another transmission 
speed . 



2. BUSY TONE 



3. HOST DOWN 



If received when dialing the TYMNET network, 
wait a few minutes and try again. If the busy 
tone persists, call the local telephone repair 
service to check if the local lines are truly 
busy or out of service. If lines are continously 
busy, but not out of service, notify the Multics 
Computer Center. 

Indicates the Multics system is not In operation, 
Wait and try later or contact the Multics 
Computer Center. 



u. ERROR ON PORTn System is operational, but a specific port 

or channel is not answering. Notify the Multics 
Computer Center. 



To 



report trouble call the Multics Computer Center - (602)249-77 
or HVN 341-7567 



G-5 



F01 



TYMNET TELEPHONE NUMIBERS 



ALABAMA 




FLORIDA 




Birmingham 


^05/9'^2-4l41 


Fort Lauderdale 


305/467-7550 






Jacksonville 


904/721-8100 


ARIZONA 




Miami 


305/374-7120 


Phoenix 


602/249-9261 


Orlando 


305/841-6850 






Pensacola 


904/434-5514 


ARKANSAS 




Tampa 


813/229-0981 


T •±,A,"i_ r\„_i- 


r- r\ A /'-»'■»'% i~ i-T n r\ 


C^ JL. lT»_i--_*.t-..-— — * 


Ol'i ITT ^ C ^TO'^--l 


L-ittie nocK 


DV I / ^1 ^-D 1 OU 


o . r e b e s o u r g 


o i3/::)3u- [ o^cj 






W.Palm Beach 


305/622-2871 


CALIFORNIA 








Alhambra 


213/572-0999 


GEORGIA 




El Segundo 


213/640-1570 


Atlanta 


404/659-6670 


Los Angles 


213/629-1561 






Los Angles 


213/683-0451 


HAWAII 




Mountain View 


415/961-7970 


Honolulu 


808/521-7481 


Mountain View 


415/941-8450 






Newport Beach 


714/540-9560 


IDAHO 




Oakland 


415/465-7000 


Boise 


208/343 -4851 


Oxnard 


805/487-0482 






Palo Alto 


415/326-7015 


ILLINOIS 




Riverside 


714/325-9372 


Chicar^o 


312/346-4961 


Sacramento 


916/441-6550 


Chicago 


312/368-4607 


San Clemente 


714/498-3130 


Freeport 


815/232-2181 


San Diego 


714/291-8700 




(30 cps) 


San Francisco 


415/391-9325 


Freeport 


815/233-2186 


San Jose 


408/984-5500 




(10 cps) 


Santa Bc.rbara 


805/966-3184 


Rockford 


815/398-6090 


Santa Rosa 


707/526-2180 






Van Nuyr. 


213/986-9503 


INDIANA 








Fort Wayne 


219/424-5162 


COLORADO 




Indianapolis 


317/257-3461 


Colorado Spring 


S303/471-9815 


Marion 


317/662-0091 


Denver 


303/458-7921 


Southbend 


219/259-9941 


CONNECTICUT 




IOWA 




Bridgeport 


203/579-7820 


Cedar Rapids 


319/364-3371 


Danbury 


203/792-3060 


Des Moines 


515/280-9600 


Darien 


203/655-8931 


Iowa city 


319/351-4046 


Hartford 


203/568-2610 






New Haven 


203/787-5974 


KANSAS 




Waterbury 


203/757-2537 


Topeka 


913/233-1612 






Wichita 


316/265 -1241 


DELAWARE 








Wilmington 


302/658-5261 


KENTUCKY 








Louisville 


502/361-3881 


DISTRICT OF COLUMBIA | 






Washington 


703/341-0200 


LOUISIANA 




Washington 


703/841-9560 


Baton Rouge 


504/927-6400 






Lafayette 


318/235-5202 
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EW JERSEY 
Englewood Clif fs201 /89^-8250 

Moorestown 609/235-3761 

Piscataway .^01/981-0370 

Princeton 609/^52-8228 

Wayne 201/785-4480 

Union 201/964-6300 



:W YORK 
Albany 
Buffalo 
Corning 



New Orleans 


504/586-1071 


URYLAND 
Annapolis 
Baltimore 


301/268-9290 
301/547-3100 


1ASSACHUSETTS 
Boston 
Boston 
Cambridge 


617/964-3925 
617/964-3900 
617/491-5476 


IICHIGAN 
Ann A»"bor 
Detroit 
Jackson 
Kalamazoo 
Southfield 
St. Joseph 


313/665-2627 
313/963-3388 
517/784-8522 
616/385-3150 
313/355-2950 
616/429-2568 


INNESOTA 
Minneapolis 


612/854-6659 


ISSOURI 
Kansas City 
St. Louis 


816/753-6620 
314/421-5110 


EBRASKA 
Omaha 


402/329-2970 


EVADA 
Carson City 
Las Vegas 


702/882-7810 
702/386-1899 


EW HAMPSHIRE 
Nashua 


603/888-3354 



518/463-31 11 
716/856-1400 

607/962-5071 



Huntington, L. 


1.516/673-5780 


New York City 


212/350-9100 


New York City 


212/551-9322 


New York City 


212/344-7445 


Niagra Falls 


716/285-9354 


Rochester 


716/546-1410 


Syracuse 


315/437-7111 


White Plains 


914/761-8449 


NORTH CAROLINA 




Charlotte 


704/376-0320 


Durham 


919/549-0441 


OHIO 




Akron 


216/535-1861 




(30 cps) 


Cincinnati 


513/242-7040 


Cleveland 


216/781-7050 


Columbus 


614/421-7270 


Dayton 


513/223-3847 


Toledo 


419/243-3144 


OKLAHOMA 




Oklahoma City 


405/947-0561 


Tulsa 


918/492-5306 


Tulsa 


918/492-1687 


Tulsa 


918/663-2220 


OREGON 




Portland 


503/224-0750 


PENNSYLVANIA 




Allen town 


215/433-6131 


Erie 


814/725-8671 


Erie 


814/454-6467 


Harrisburg 


717/236-1190 


Philadelphia 


215/561-6120 


Pittsburgh 


412/765-1320 


Valley Forge 


215/666-9190 


York 


717/846-4802 


RHODE ISLAND 




Providence 


401/351-2920 



SOUTH CAROLINA 
Greenville 

TENNESSEE 
Memphis 



803/271-2418 
901/345-1111 
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(30 cps) 






Montreal 


515/878-0589 


TEXAS 






(14.8 cps) 


Austin 


512/444-3280 


Montrtial 


514/878-0588 


Baytown 


713/427-1123 




(10 CDS) 


Beaumont 


713/832-2589 


Ottawa 


613/563-9841 


Dallas 


214/638-5800 




(30 cps) 


El Paso 


915/544-9590 


Toronto 


416/863-6202 


Ft. Worth 


214/263-2341 


Vancouver 


604/688-9811 


Houston 


713/785-4420 




(30 cps) 


Houston 


713/785-4411 


Vancouver 


604/688-4838 


Houston 


713/780-7390 




(14.8 cps) 


Longview 


214/758-0801 


Vancouver 


604/688-4338 


Lubbock 


806/762-2402 




(10 cps) 


Midland 


915/683-5645 






Odessa 


915/563-0273 






San Antonic 


512/734-7381 


ENGLAND 








Conta<!t Allen 


Jenkins at 


UTAH 




01-606-4671 or 


• 01-432-5573 


Salt Lake ( 


ity 801/582-8972 


for further de 


stalls to use 






the Data Base 


Service of the 


VIRGINIA 




British Post Office. 


Norfolk 


804/622-0435 






Richmond 


804/649-3050 










FRANCE 




WASHINGTON 




PARIS 




Seattle 


206/622-7930 


Contact Mr. 
DTRI 


Feuvrier 


WISCONSIN 




246 RUE DE BERCY 


Madison 


608/221-4211 


PARIS CEDEX 12 


75584 


Milwaukee 


414/257-3482 


(All France is 


"Toll Free" 


Oshkosh 


414/235-4594 


to TYMNET Nodes) 






346-12-55 EXT. 


4331 






TELEX: 670372 


BELGIUM 








Brussels 








Contact E. 


. Godhaird 


GERMANY 




233-3700 




FRANKFURT 








Contact Mr. 


Helmuth Wolf 


CANADA 




(611) .211.33 


.20 


Calgary 


403/263-7301 
(30 cps) 






Calgary 


403/263-2006 


HOLLAND 






(14.8 cps) 


AMSTEi^DAM 




Calgary 


403/263-2072 


Contact Mr. 


V. Moorsel 




(10 cps) 


070-753652 




Edmonton 


403/423-4888 






Montreal 


514/878-0584 


MEXICO 
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MEXICO CITiT 

Contact Mr. Rafael Rivera 
of GONACYT 
905/52i|-7365 



NETHERLANDS 
The Hague 



^6-97-61 



^UERTO RICO 
SAN JUAN 

Contact Ar . Ed Lukas 
724-3989 . 

>PAIN 
MADRID 

Contact Mr. Jaime Carvana 

248-8531 
.WITZERLAND 
BERNE 

Contact Mr. Urs Loosli 

022-28-7 117 

(All Switzerland is 

"Toll Free" to TYMNET Nodes 
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ABBREV EXAMPLES 



CRF "-ds CRF_cabinet" 

^ -Pwl "cwl &1; twl &1; pwl &1; dl &1 .wl" 

:wla_ad "tape_ansi_ 1 -create -name sample -number 1 -format db 
-expires 12/31/99 -density 800 -ring" lormai^ ao 

Dirs ([dirs **]) 
Segs ([segs »*]) 



GRT 



FORDAK 
FORRRR 



am 
DEFtR 

no 



-ctl "p-^a ^a^a y-^.Sf r^ . 3f m'^ . 3f b'^d d^d $".2f'^/" -date 
-hour- -min -vt -rt -mut -pgt -$t 



Gcns "dev user_i/o -dim syn 

FOREDW -ds "FOR Wallman" -he "AT PCO" 

-ds "KAYDEN: CISL" -he "Cambridge MA" 
-ds "STA-D DVP" -he "RON RIEDESEL" 
-dtm -dtcn -sort dtcm 
-dtu -dtu -sort dtu 
-master -in 15 -dv dtc300s -hyph 
bob Alvarado 

E [home_dir]>exl 

JUNK [pdj>junk_ 
ME [user name] 

-wd [wdj 

-^^■^ ac X ([segs ** .archive] ) 

accept_messages; iiemo -on 



def.^'^^fiMM.f ^' "t"" ""^"^ >udd>m>lls>ec>me3s handle 
defer &f1""";gr -set -call "print messa^^^es" " 



r 



answ< r no --brief 
^^2t answe-r rest 

yss answer yes -brief 
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b 


xpll 




:ale 


b 


sysup 


b 


ivt 


b 


unmask 




athvn 


b 


cl 


b 


cispn 



asr >exl>o -before >sss 

asr >udd>Demo>dbm_test>linus>executable -after 
work Lng_dir 

calc "(page_fault_histogrami pfh . last_pf_time) - 

(disk_traffic_datal2,d)/6000000" 

calc "(tc_data!400+apte.virtual_cpu_time)/60000000" 

call hcs_$set_ips_mask -o -2 -r -o 

can be reached at 703-790-3213, hvn 231 

cf-a;rl-a 

check_info segs -pn >doc>iml_info>** . info -pn 
>doc>Tnfo>'**.info -pn >udd>m>lib>info>** . info -pn 
> e X 1 > 1 n f o > * * - i n f o 

ro ro; am -pr -bf; rdy 

mnth comp monthly -in 10 -of [month_name] .report -pm 
[month_name] -pass 2 

b rtape copy_file ids [string tape_ibm_ [response "tape 
name:"] -nb [response "file number on tape:"] -bk 
[response "block length:"] -rec [response "rec 
length:"] -fmt fb --mode [response "ascii or ebcdic:"] 
-den [response "density:"] -no_labels -retain all] -ods 
[string record stream_ -target vfile_ [response 
"segment name:"]T 

b wtape copy_file -ods [string tape_ibm_ [response "tape 
name:"] -nb [response "file number on tape:"] -bk 
[response "block length."] -rec [response "rec 
length:"] -fmt fb -ring -cr -mode [response "ascLi or 
ebcdic:"] -den 1600 -no_labels -retain all] -ids 
[string record_stream_ -target vfile_ [response 
"segment name:"]] 

b cpa cpa -minlines 1 minchars 2 

U cwd < 

b LSOLD cwd >udd>m>tac>s ; in ls;tmr ls;dn Is In lt;an working_ls 
Is m It 

b return cwd [value old_dir]; pwd 
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b owdd cwd; cwd 

b tapelist cwd;fo tape_list;tapac tl cdt;ro;dp -dl tape list 
t> h Gwd;pwd 

b /status date_time;ioa_ [string "USER ID •• ^^^3^^ ^ . 
Luser project] ]; ioa $nnl "TERMINAL NUMBER "-user 
SYSTEm/^^""^^'"''^- '^^^'^^"g [system n_users] USERS ON 

b :dd dd -force 

^ ^^ defer_messages; memo -off 

NUGAMES df p>new games -bf;fo p>new_games ; do "ioa &1;lsd &1 -a 
P>new ^amerSl''"'" P>f mejist] ) ; ro;cpa p>master games 
mast^F'games P>niaster_games ;rn p>new:games 

^ C>IE dl [pd]>stack_4 

later dm;a -hold -c..ll do ""sms [1ms] Messages Deferred.""" 

' "'^^'^ • ^^ "answer yes -bf move test>&1 . runout save> = = " 

'^"^ ^? . ^ "^omp &1.info -of &1.info -gl-an 
&1.info.compout &1.info; dn &1 . info .compout" 

''^ ?est>*»]) "'^''- ^^'^^^ ^""^>^^ ^^^^>^^ 5 1" ([segs 
do^"^answer no -bf cr &1.p; tc &1.p; fo &l.p; profile 



,pf 



: rm 



cpmsT 
finde 



do^^" rdn; gr -control ""VYes Master??V"" -set -call 



''^P ^o " set_tty -ttp viD7200 

echoplex, 1180, ^ctl_char, polite, replay, &f1" 

^°* do "&1 ([segs &2])" 

do "&1 [directory &2]>([fiies &2]) &f3" 
please do "&qfl" 



-modes 



do "(cd cwd) [entry &1];cp -acl &1>»» ---owH ^ - <.Hn 

[entry &1] &2" , f cil.x & i ^ --,cwd <,sbc 

do ". call hcs_$make_ptr -1|1 &i &2 -r -111 -r -o 0" 
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b 1st do ". call lib_sort_tree_$by_primary_name -p &1 ~p &2 

-p &3 -P &4" 

b cr do ". create &1 ; if arg &2 -then ""addname &f1""" 

b rf do ". dm;rf &f1;ioa_ "3/Done.;am -short -print" 

b pcd do ". if arg &1 -then "". pcd <^f1"" -else "". pcd mem 

cpu j)age""" 

b macabsl do ". if argeq true [exists segment &1.absout] -then 
""truncate &1.absout""; ear &1 -rt -q 1 ~ag [spe &1 ] 
[suffix &1]" 

b find do ". in &1 ; Irn &1" 

b sval do ". ioa ""''a: ''^a' changed to '^a'"" &1 [string 

[value &1]T &r2; value$set &1 &r2" 

b valu do ". ioa_ [string [value &1]]" 

b gpi do ". ioa_ ^a [gpn ""&1"" &2:i" 

b listprog do ". list -nm -all -bf -sort nm &1.**" 

b IPSstaff do ". memo -al -time ""1245. &1"" &2 [substr [day_name 
&1] 1 3]"" 1300: IPS Staff Meeting""" 

b rui do ". on cleanup im -brief ""dm; runoff &rf1; im; 

ioa_$nnl """ 

b :def do ".abf :rd do "":r &1""" 

b :4 do " .af : :comp &1 " 

b :2 do ".af : :pl1 &1" 

b WEEKLY do ".l";ioa_ ''!;ws >udd>m>lls "Is -all -sort dtu 
-mode -length -name -dtem -dtu";do "ioa_ "!;pr 
>udd>m>lls>ec>&1" ([segs >udd>m>lls>ec>** J ) 

b PLI do ":2 [spe &1 pl1];LK &1 list pl1;UL &1 pl1;pl1 &1 

-map &f2;:3 [spe &1 pll ] . list ;SEVERITY pll &1 " 

b COMP do ":4 [spe al compinj;LK &1 compout compin;comp &f1 
-of;:3 [spe &1 compin] . compout" 

b :cLspn do ": If 4; ws &1 ""cis -pn [wd]>** -dt [default [value 
doc_c:hanges_date] &2] &3 &4 &5 &6 &7 &8 &9""" 
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■^ ^dodd do ":par &l;ear [horne_dir]>&1 -tm [response ""What 
time?""] -ag do Lwd] &fr2" 

b zap do ">udd>m>ab>value$set dir [wd] -cm ""Set by the zap 
abbrav"" ; new_proc" 

b ABS do "ABSUT1 &1 &r3;ear ME>&1 -rt -q [default "2" &4] -of 

pooldir>&1 .absout -bf -ag &1 Sc2 [fl ""-^a"" &5 &&] 
&r3;lar -position -q [default "2" &4]" 
[>udd>m>rab>new>abs_date] [wd] 

URAT do "C [sysn] / [sysm]" 

b MOKE do "HEY : : sm &rf 1" 

b KEPLY do "HEY [1ms] &rf1" 

^ ^PW do "ac xf &1 [pd]>[entry &2];if is [pd]>[entry &2] 

-then ""compare [pd]>[entry &2] &2 &3 &4:dl [pd]>[entrv 

b pushname do "add_name &1 &!; delete_name [directory &1]>([name 
&1 2]); -ename [directory &1]>[name &1 11] &2- 
add_name Ldirectory &1]>&2 [name Sd]; delete name 
[directory &1 ]>&!" - 

^ sm do "am -print ;send_raessage &f1" 

ci<m do "answer no mail >udd>&2>&1 >&1 " 

b no do "answer no -bf &f1" 

=pr_cal do "calendar &1/01 -fw holidays birthdays" 

^ CD do "cd &1;SIS &1;SID &1 " 

:cmpsr do "comp psr.[substr &1 1 3] &f2 -pm ""&1 , 1978"" " 
[month_name [response "Month No? (1-1 2)"] /I]' 

3 :cmpmsf do "compare &2>&1 &3>&1 " ([index set [response "Last 
comp_no?"]]) 

^ cpit do "cpa &1 <(old new)>==" 

^"^"^ ^° "create_dir &1;(sis sid) &1 (rew sma) [user 

name];(sis sid) &1 (re s) *;da &1 [user name]. [user 
project];sa &1 (sma s) ([user name]. [user project] »)" 

^ypos do "create_wordlist &1;trim wordlist &1 wl- 

print wordlist &1 .wl" ~ ' 



H--^ 



F01 



ABBREV EXAMPLES 



b yet, do "cwd;if [less [value Time] [time]] -then ""ioa_ 
YESI!"" -else ""ioa_ No.^x[value Time]"";cwd &1»' [wd] 

b cig, do "cwd; value$set Time [time 30 min];cwd &1" [wd] 

b setre do "da &1 ..;sa &1 re *.*.*; da &1 * .SysDaemon .»" 

=dla do "dl &1.(absin absout)" 

b REFRESH do ".11 [i)d]>[entry &1 ] -bf;mv &1 [pd]>[entry &1];mv 
[pd] >[entry &1 ] &1" 

b qxab do "-11 [pd]>abr -bf;fo [pd]>abr;if arg &2 -then ""do 

"""".u &^?"""""";do "".1 &q1"";do "".u"";ro;if isnzf 
[pd]>abr -then ""qxr [pd]>abr Is/'^/e.a/ s/"e.ab*/&if/ 
1p"" ' 

b comp do " Im; cc>mpose &f1; am" 

b irfdtm do "dm; memo -off:rf &1 -pm [string [year] [month_name] 

[day; at [time]] &f2;im;memo -on" ' ' ~ 

b filexist do "'lo ""if [exists segment &&r! -then -else """"ioa 
&&1it.itMMt. ([contents &1])" 

b :dpnt do 'dp -ds ""MAY, CABINET"" -he [string [default 
[upp.ir_case [entry &1]] &r2]] -q [default 3 &3] -ned 
&f4 i1" 

b dofa do ";^a &1 &2 ""push_wdir [if [ngreater [index [status 
-tp d ] directory] ] -then &1 -else [directory &1]]; 
&3 &''f4; pop_wdir""" 

b ADDTIME do " o &1.List;ioa_ " 1^3/ ; pi 1$times ; ro" 

b fout do " o &1 ; Lo detach error_output ; io attach error_output 
syn_ user_output" ~" 

=dsrc do "io =cp>+src .&1 . list ;ds [=gtt>aft »src] -ch;ro;ioa 
""+sr C.&1 . list Created.""" 

b ,,log do " f o >udd>m>ejw>[month_namej .log_time; ioa_$nnl 
[dati_time]; ro" 

b CALENDAR do "fo CPS>calendar ; calendar [date] -fw 
HDS>j >holidays;do ""calendar """"&&1 month"""" -fw 
HDS>i >holi days"" ([index_set 12]);ro;DPDL CPS>calendar 
&f1" 
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^^ ^o "if [and [not [exists segment &1.ec]] [exists 

segment &1,absin]] -then ""an &1.absin &l.eG;€xee com 
&fr'" -else ""exec_com &f1""" ~ 

^ usage do "if [equal &n 0] -then ""ps usage: Usage is: 
usage"" -else ""ps usage: Wrong number of arguments 
supplied. For usage instructions, type 
""""usage""""""" 

^ ^^ tlo "if [exists argument &1] -then ""release -all"" 

-else ""release""" 

^ ^^^^^^^"^ do "if [greater [status &1.pl1 -dtcm] [status &1 
-dtcm]] -then ""ps &1 has been modified""" 

b fi"i do "if [have_mail] -then ""mail &rf1"" -else ""do 
>udd>m>vv>baseraent>say; logout &rf1""" 

b ansrvxxx do "if [or [equal [format_line ^a 
[last_mei;sage_sender]] [user name]] [equal [string 
[sutstr [ last_message] 1 10]] Acknowledg]] -then -else 
""sns [last_message_sender] """"(Answering 
service);"""" &fi""" 

b TALK do "am;sm &1 &2;dm" 

b ARDIND do "ind lc^ -Ira 3 -in 2 &f2" 

b :indip do "ind &1.incl; if [query Bad?] -then ""do ""im.p 
[pd]>&1 . ;.ncl . ind""""""" 

t> deo do "io attach junk discard_ io open junk so;io detach 

error_output;io attach error output syn_ junk; deo;iiess" 

^ ^^^ do "io }lose junk;io detaoh (junk error_output) ; io 

attach ei'ror_output syn_ user_i/o; reomess" 

^ syn do "io_call attach &1 syn_ &;?" 

5 e do "ioa_ ""NOT TED""; do ""&ri &rf2""" 



) GONE 



do "ioa_ ""I WILL BE AWAY ':IL &1 - LOG ME OUT IF YOU 
NEED THE TERMINAL"" " 



asd do "link (&f1) [home_dir ]>hh>==" 

» Isw do "list [where &1] &rf2" 

' first do "Is -nhe -first [default I &1]" 

prmail do "mail >udd>&2>&1 >&1 &f3" 
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b 


:pl1 


b 


:lo 


b 


P 


b 


prf 


b 


:dpx 



b 


:pxa 


b 


= exc 


b 


vip 


b 


reply 


b 


w 


b 


ddl 




dpi 


b 


Iv 


b 


RDN 


b 


linus? 


b 


lOCD 


b 


speak 




= edl 




=er;o3 



t> bday do "memo -alarm -repeat 12raonths -date ""&f3"" &1 &2 ' s 
birthday!" 

CO "pll &1 -table -symbols &f2;ioa_ Done." 

CO "pmotd; if [have_mail] -then ""if [query MAIL?] 
-then "tiHiimail""""""; logout &1 &2" 

do "pr &1 1 9" 

do "print &1. runout 1 " 

do "px &1 -sm :cp>[entry &l].px; dp -ds ""MAY, 
CABINET"" -he [string [default [upper_case [entry 
&1].px3 &r2]] -q [default 3 &3] -ned -dl &f4 :cp>[entry 
&1].px" 

do "px &1!** -sm :cp>[entry &1 ] .archive. px &f2" 
do "rn &1 !!!!;rn &2 &1;rn !!!! &2" 

do "set_tty -ttp vip7200 -modes 
echoplex, 1180, polite, replay, &f1" 

do "sm [nmf_last_sender3 &f1" 

downlog memo -al -tm [minus [system next_down_time] .1] 
-call LOGOUT// 

dp -dl 

dp -dl [segs **.lii;t3 

general_ready -control "a"/ -level; 

gr -string [substr [string [system installation_id] ] 1 
1] -date_time -level -set -call pm;dm;memo -on;rdn 

help -pn >udd>Demo>dbmt>x>doc>(linus linus_pre_release) 
io (close detach) 

io (close detach) user_output ; io attach user_output 
syn_ user_i/o 

io attach efo_ discard_;io detach error_output ; io 
attsch error_output syn_ efo_ 

io_call attach error_output vfile_ 
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b :open io call open flleO(3 4 5 9); io call position fileO(3 4 
b 9 ; Dof ~ 

b mark ioa "0 i ? ^ i, 
0. ^ ' ^ ' ' • S . 9 . 

^ ^'^^ f^^-, "^"sers -^ara) (units ^a-a)" [system n users] 

[system max_userii] [system n_units] [system max_units] 

b down? ioa_ "Schedu'ed shutdown: -^a ^a " [svstem 
next_down_date] I system next_down_timeJ 

' ^^^^ i°^- "'^53/Fromr--a.-aVTo--Whom It May ConcernV" 
[user name] [user project]; Ike -time 60 -gr 3 -sow 
[value pass] ^ 

5 WAIT Ike -gr 5 -nol 

newu logout -hold 

Dear mail * 

) mail? mail -brief 

' ti745 stty -delay 0,0,0,0,0,0 

' tniOO stty -modes tabs, H1 18 , replay, polite; tab_set 

^^^^ stty -ttp rosy -modes '^eehoplex , 11130 

'^''^^'' o'!:i[8,o!o!o,59"^°° "''''^^^ tabs, 11130, vertsp -delay 

whoa who -absentee 

VP^"? who .VPI1 .VPI2 .VPI3 .VPI3 .VPin .VPI5 

liz? who LMullen 

r^^L'"^^ "ff.-^^^!§?x*^^ ^^ *.».*;sa ([segs *.».»*]) r 
*: i i'*./^''"" ^^ " ».*.*;sid [wd] 3 *%.*;sis [wd] 



PUBuIC 



PRIVATE 



ws [wd] "da ([segs *»] [dirs *»]) ».».»;did ([dirs **]) 
*.*.*;dis ([dirs »»]) ».».»" vl ^ j; 
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NOTE: Because these worksiiops build upon one-another, you should 
follow the instructior's precisely, using the names indicated. 

Throughout these workshops, the Person_id "Student_??" is 
intended to mean your own Person_id. ~ 

1. Refer to the section "Ac:cess Sequence" in topic 2, and log in to 

Multics. 



2. Exercise the delete character (#) and the delete line (@) 
symbols. For example, type the following how_many_user commands: 

hmu 

hnu##mu 

jmu§hmj T#//#u TSmith 

3. Type the following commands and observe the results. Supply the 
answer "yes", "no", or "rest" when asked. 

help hmu 

help sked 

help help 

4. Enter the accept_messa£,es mode by typing "am". Note that the 
accept_messages command created a mailbox for you. This mailbox 
is now a permanent part of your file space. You can now receive 
messages. 

List the names of all segments (files) that belong to you (Is). 
Note that your mailbox is the only segment you have. 
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5. Type the following sequence of who commands and observe the 
results of each form. 

who 

who .F01 

who .F01 -long 

who Student_04 

These are the names and projects of users who are currently 
logged in. Note your own "name". 

6. Select two or three FOl users who are currently logged in and 
send them messages. For example, the following commands will 
send messages to Student_04 and Student_09: 

sm Student_04 .F01 Does this really work? 
sm Student_09.F01 Great class, isn't it? 

7. Send yourself a message. 

sm Student_?? FOl From me to you! 

8. Enter the defer_mossages mode (dm) and again send yourself a 
message. Note that you did not receive the message as you did 
before. The message is in your mailbox and will remain there 
until you print_mtjssages . Print the message(s) in your mailbox 
(pm) . 

9. Again, send yourse.'.f a message. As before the message was placed 
in your mailbox because you are still in the defer_messages mode. 
Return to the acc(;pt_mes5ages mode (nm). You will now receive 
messages immediately, as they are sent. Note that the 
accept_messages command did not print messages currently in your 
mailbox. Print the message(s) in your mailbox. 
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10. Determine the current system configuration by typing the 
following print_conf iguration_deck commands: 

pcd cpu mem 
pcd 

11. Type the following sequence of commands: 

date 

date_time 

long_date 

time 

minute 

hour 

day 

day_name 

month 

month_name 

year 

While available in this form, these commands will take on more 
.significance when the topic of "Active Functions" is discussed. 

12. Generate^your resource usage report for this billing period by 
typing the resource_usage command (ru). 

Note: Your current login session may not be reflected, however, 
if other F01 classes have been conducted this month, you 
may see considerable usage. 

J. Log out (lot.out) and return to the classroom. 
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1. Log into Multics. Accept messages (am) and print messages (pm) 
if desired. List the riames of all segments (files) that belong 
to you (Is). Note that you still have only one segment, your 
mailbox. 

2. Invoke the qedx text editor (qx). Do not expect a ready_message 
as you are now in the qedx subsystem. 

J. You jre in the edit mode of qedx and have an empty buffer (a 
scratch-pad). Ent^^r the append mode (a) end type the following 
threi lines exactly as you see them: 

In anything att all, perfection es attained 
when there is no longer anything to take away. 
1,2p 

4. Return to the edit mode (\f) and print the contents of your 
buffer (1 ,$p) . 

5. Correct the intentional typing errors, as well as any you may 
have made. For example, to change "es" in the first line to 
"is", type the sequence: 

1p (positions you to the first line and prints it) 
s/es/i:j/ (substitutes all "es" strings for "is") 
p (prints the current line) 

To remove the last line, type the following: 

$p (positions you to the last line and prints it) 
d (deletes the current line) 

6. After correcting all of the errors, write the contents of your 
buffer to a segment by the name of seg_1 (w seg_1 ) . 

7. Quit the editor (q) and note the ready messiige. You are now back 
at command level. Your qedx buffer has been destroyed. (Don't 
confuse your qedx buffer with the permanent storage system 
segment seg_1 ) 

8. List the names of all segments that belong to you (Is). Note 
that seg_1 was created for you by qedx's "w" request. 
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r 



9. Invoke qedx. You again have an empty buffer. (Confirm this by 
printing the contents of your buffer.) Read the contents of 
seg_1 into your buffer (r seg_1 ) and again print the buffer's 
contents. 

10. Append the following text between the first and second line of 
your buffer by typing the following requests: 



1 1 . 



1p 

a 

not when there is no longer ajQ.^thing to add, but 

Return to the edit mod^ — k\f^ — and print the contents of your 
buffer. Correct any typing errors. 



12. Write the contents of your buffer to seg_1 again. This write 
will replace the old contents of seg 1 with the contents of your 
buffer. 

13. Print the contents of your buffer. Note that tho. above write did 
not affect the bufi'er's contents. Write the contents of your 
buffer to seg_2 (juit for fun). The contents of seg_1 and seg 2 
are now identical. ~" 



WORKSKOP 2 CONTINUED ON NEXT 
PAGE 
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1^. Type the following sequence of qedx requests in exactly the 
order as shown: 



/ ,$s/^/zzzjf/ 

/ ,$P 

g sm Student_?? .F01 Can I do this within qedx? 

1,$s/zzz// 



• 1 ,$P 
w 

/is/ 
/is/ 
/is/ 
/is/ 
1,$d 
1 ,$p 
r seg_ 1 
r seg_1 
w seg_1 
r seg_2 
1,$p 
w 

5,$cl 
1r seg_1 

1 ,$P 



(To which segment did you write?) 

(Notice the wrap-around) 
(Why is your buffer empty?) 
(Remember the default address here?) 

(Why has qedx forgotten the pathname?) 
(We're forcing the read address) 



15. Quit the editor. Note that qedx allowed you to quit even 
though you had not written out your modified buffer 
(Hsssssss! ) . 



16. Print seg 1 (pi' seg 1). It's contents should be 



seg 1 



In anyth: 


Lng 


at 


all 


, perfection 


is 


attained 


not 


when 


th 


ere 


is 


no longer an 


yth 


ing to 


add, but 


when 


ther 


'e 


is no 1 


onger anythi 


ng 


to take 


away. 


In anything 


at 


all 


, perfection 


is 


attained | 


not 


when 


th 


ere 


is 


no longer an 


yth 


ing to 


add , but 1 


when 


there 


is 1 


TO 1 


onger anything 


to take 


away. j 



17. List the names of your segments and log out. 
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1. Log in. Accept and print messages if desired. Execute the 
print_wdir command (pwd). This is your home directory and is 
currently your working directory. 

2. List the names of the segments in your working directory. 

3. Print the contents of your seg_1 segment (pr seg_1 ) . 

4. Create a segment by the name of Prince (cr Prince). List again 
the names of the segments in your working directory. Note that 
Prince has a length of zero records (i.e.: it is empty) 

3. List names of all entries in your working directory (Is -all). 
Note that you have no subordinate directories. 

6. Creat,e a :;ubordinate directory by the name of Programs 
(cd Programs). List again the names of all entries in your 
working directory. 

7. Chan;^e your working directory to Programs ( cwd Programs). Verify 
the change by printing your working directory. 

8. List the names of the segments in your working directory. Note, 
of course, that your Programs directory is empty. 

9- Without changing your working directory, print the contents of 
your seg_1 segment located in your home directory 
(pr >udd>F01>Student ??>seg 1). What would (pr seg 1) have done*? 
Try it. ' ~ - 

10. Return to your home directory (cwd). Why is no pathname required 
for the cwd command in this case? Verify that you are back in 
your home directory. 

n. Change your working directory to Student_01's home directory 
(cwd >udd>F01>Student_01 ) and verify this change by printing your 
working directory. What would the command "cwd Student_01" have 
done? If you're not sure, return to your home directory and try 
it, but remember to change back to Student_01's home directory 
before continuing the workshop. 
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12. List the names of the segments in your working directory. 
Understand that this is Student_01's home directory. You are 
able to list the names of his segments only because he has 
granted you access to do so. Note that you have recid permissions 
on many of Student 01 's segments. 



IJ. Print the contents of Student_01's treasure_hu:it se[;ment and obey 
^j11 instructions specified. You are able to print the contents 
of this segment only because Student_01 has gr.mted you access to 
do so . 

14. Change your working directory to the systen's root directory 
(cwd >). Verify by printing your working directory. List all 
directories under the root (Is -d) . These are the system level 
directories. Note that they are primarily system libraries. 
Feel free to explore — time permitting. 

15. Return to your home directory and execute the ''ollowing commands: 

cr X (create) 

Is X (list) 

dl X (delete) 

Is X (list) 

dl >udd>F01>St'jden _01>treasure_hunt (delete) 

Why were you unable to 'leleta Student_01's treasure_hunt segment? 

cd X (create_dir) 

Is X (list) 

Recall that by default, the list command only deals with 
segments. 

Is X -d (list) 

ddX /'H£i^£i^-^»/^^v'^ 

16. Add the names s_1 , si and sl.compin to your seg_1 segment 
(an seg_1 s_1 si sl.compin). List the contents of your working 
directory. Notice how the alternate names are listed. 
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17. Print the contents of seg_1 using one of the alternate names 
(pr si). Get the status of seg_1 using another alternate name 
(st s_1 ) . Compose the contents of seg_1 one using the name 
sl.compin (comp sl.compin). Note the full-page formatting done 
by the compose command. 

18. Delate the se gment seg_2 (dl seg_2). List the contents of your 
working direti^tory. Notice the change in the segment count. 
Attempt to print seg_2. 

19. Delete the names seg_1 , s_1 , sl.compin (dn seg_1 s_1 sl.compin). 
List the contents of your working directory. Notice that the 
segment count is unchanged. 

20. Rename the segment si to seg_1 (rn si seg_1 ) . List the segment 
seg_1 (Is seg_1 ) and observe the add names. 

21. Rename seg_1 to Prince (rn seg_1 Prince). Answer "yes" to delete 
the original Prince segment. (Recall that it is empty and is of 
no practical use to you.) 

22. Attempt to delete the name Prince (dn Prince). Since this is the 
only name on the segment, the command will inform you that 
deleting the only name on a segment is not allowed. 

23. Copy the segment >udd>F01 >Student_01 >alphabet into your working 
directory (copy >udd>F01 >Student_01 >alphabet) . List the contents 
of your working directory and print the contents of this copied 
segment . 

Why does your oopy also have the name alphabet? What would the 
copy command look like if alphabet was to be copied and called 
my alphabet? 
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1. Log in. Accept and print messages 
working directory. 



if desired. Print your 



2. Change your working directory to >udd>F01 >Student_01 . Execute 
the following commands: 

^^ seg_1 alphabet 
^ * 

^s».»« 
^ *.* 

Ls *.* -exclude s*.* 



3. 



we^urn to your home directory and execute the following sequence 
0/ commands: (Note: If the printer queues are near empty, you 
may not be able to cancel some of your dprint requests) 



-4r" 



Idr 

dp Prince 

dp -q M Prince 

Idr 

Idr -all 

cdr -q 4 Prince 

Idr -all 

cdr Prince 

Idr 



( list_daemon_requests) 

(dprint) 

(dprint) 

( list_daemon_requests) 

(list_daemon_requests) 

( cancel_daemon_request ) 

( list_deamon_requests) 

( cancel_daemon_request ) 

(list daemon requests) 



Note how some of these commands reported the total number of 
requests (system wide) as well as your total number, but only for 
the specified queue. 

/ 

-f--tM«re is an on-line printer accessible to you, dprint (for 
ke^p/s) the contents of your Prince segment (dp Prince). Do you 
reVall what the default heading and destination banners will be? 
Re^mfember to pick up this output sometime before class tomorrow 

mn rrri no. ' 



\ 



5. -'Enter the abbrev mode (ab) and type some command, such as pwd . 
Note that a profile segment was created for you. List the 
contents of your home directory and note this new segment. 
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6 Type a period (.). The reply is from the abbrev processor 

confirming the fact that you are in abbrev mode. Quit the abbrev 

mode (.q) and again type a period the see 
processor will do with it. 



what the command 
Re-enter the abbrev mode. 



7. 



8. 



Create an abbreviation for your User_id by typing a command line 
similar to the following: 

.a HE Student_??.F01 

Check your abbreviation via the show request (.s ME). Recall the 
abbrev break characters and observe how they function by typing 
the following lines: 

.s Who is ME? 

.s Who is ME. 

.s Who is MEAN? 

.s Who is ME, the_great? 

.s Who is ME the great? 



9. Use your abbreviation to send yourself a message. For example: 
sm ME Does this work? 



10 



Define abbreviations for those users with whom you frequently 
communicate. For example: 

.a S9 Student_09.F01 
.a S4 Student 04.F01 



11 



Lis;: all of your abbreviations (.1). List one of your 
abbreviations (.1 ME). List all of your abbreviations that start 
with "S" (.la S). 



12. Enter the qedx text editor and write the following text to a 
segment by the name "start_up .ec" . 

start up.ec 



accept_ 
print_l 
abbrev 


messages 
Tiessages 



W-12 



F01 



WORKSHOP FOUR 



3. Quit the text editor and type the following command and observe 
the results: 



4. 



ec start_up.ec 

If you received any error messages, invoke the qedx editor, read 
the segment start_up.ec, correct your typing errors, rewrite your 
corrected copy, and try again. 

Remember: From now on this start_up.ec will be invoked for you 
(automatically) whenever you log in. 

Using qedx, create another segment named A.ec containing the 
following lines: 

A.ec 



ec 


start 


up. 


ec 


time 






ec 


start_ 


up. 


ec 



Quit the text editor and type the following command and observe 
the results: 

ec A.ec 

5. Execute the print_motd command (pmotd). Note that a 
Person_id.motd segment was created for you (in your home 
directory). It is through this segment that the system knows 
what messages you have already seen. 

A ftrta-iv* &\r f>r>\\¥ et ¥ V\ a rjir ^ n¥ mn^- r\ r>r\mmsirkd ^-i nr»<a von hstv/^ flTre^dV 

seen the message of the day, the command will suppress additional 
printings. 

7. Using the qedx text editor, add the print^motd command to your 
start up.ec. 
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1. Using the qedx editor, input the following PL/1 source and write 
it to the segment "add.pH": 

add.pll 



add: proc; 

/» Written by Student_?? */ 

del (sysin, sysprint) file; 

del (I, Sum) fixed bin init (0); 

do while (I >= 0); 
"put skip list ("value? "); 
[get list (I); 
lum = Sum +1 ; 

put skip list ("Sum is:", Sum); 
end; 

put skip list ("Fini"): 
put skip; 
end add; 



Indent the PL/1 source ( ind add.pll). Correct any errors found 
by the indent command and try again. Print the PL/1 source and 
note the indentation that's been done for you. 

Compile add.pll (pH add.pH). Correct any errors found by the 
pll command and try again. 

List the contents of your working directory. Note the segment 
add.pll (created by the text editor) and add (created by the PL/1 
compiler). add.pll is the source segment, and add is the object 
segment. 

Print the contents of the object segment add. This will take a 
few minutes as the "unprintable" binary code is printed as an 
octal dump. Each \nnn represents three octal characters, which 
is 9 bits, which is one byte. 

Execute the PL/1 object program add which is in the object 
segment add (add -or- add$add). Supply positive integer values 
between and 9999 when prompted and observe the results. 
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7. Hit the break key and note the level number in the ready message. 
You are back at the command level — free to do as you please. 
Execute some command such as pwd . 

8. Type the start command (sr). The program add has been re~startec 
at exactly the same point it was at when you hit the break key. 
In other words, the program add is again waiting on you to supply 
integer values. Key in a value and see if the Sum returned is 
consistent with the previous Sums. 

9. Key in a negative valye to stop the program add. Add has 
terminated normally. Note the level number in your ready 
message. (No level number denotes level one.) 

10. Again compile your add.pH source, but use the -table control 
argument (pll add.pll -table). This will allow you to 
symbolically "probe" the object program. 

11. Again execute your program add and supply several positive 
integers as before. Hit the break key. After receiving the 
ready message type the following command: 

probe 

You are now inside the probe debugging subsystem. Note that 
probe printed a small status report about the current state of 
your process. Now type the following sequence of probe requests: 

stack 

This request traces your stack beginning with the most recent 
frame. Note the frame number of add ' s stack frame. Who called 
add, and who did add call? Probe's "current" stack frame is the 
one in which the unexpected event occurred (i.e., frame 10 if 
you're in abbrev mode). Any request that you issue will be 
rela^"'ve ^o ^his stack frame. 

use add 

This request instructs probe to make add's frame (i.e., frame 7 
if you're in nbbrev mode) your "current" stack frame. 
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where (Where are you, probe?) 

source (Print the "current" source line) 

value I (What's the value of I?) 

value Sum (What's the value of Sum?) 

let Sum = 500+Sum (Change the value of Sum) 

value Sum (What's the new value of Sum?) 

quit (Quit probe) 

12. You are back at command level. Note that your level number is 
unchanged. Type "start" and supply another positive integer for 
add. Does the new Sum reflect the change you made while in 
probe? Key in a negative value to stop the program add. 

13. Enter qedx and read the segment >udd>F01 >Student_01 >long. 
Commence printing of the entire segment and then hit the break 
key. After receiving the ready message, type the start command 
and observe the results. 

While the printing continues, again hit the break key. After 

receiving the ready message, type the program_interrupt command 

(pi). You are again in qedx, but at request level. Verify by 
typing 1,5p. Quit the editor. 

14. Print your current search rules (psr). These are the default 
search rules given to users at login. 

15. Note: The following exercise will work properly only if you have 
not executed the who command during this login session. If you 
have executed the who command, type the command: "tmr who". 

Add the name who to your object segment add (an add who). 
Attempt to list the users currently logged in (who). Suffice it 
to say: Do not indiscriminately use command names for your 
program names. 

Remove this extra name from add (dn who), and check to see if who 
command works as usual. If it doesn't work - why doesn't it? 
(For a hint, type: where who) 

16. Terminate (delete) the name who from your initiated segments (tmr 
who) and again attempt to execute the who command. 
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7. Change your search rules to include the directory 

>udd>F01 >Student_01 >tools after your working directory (asr 

>udd>F01 >Student_01>tools -after working_dir ) . Print your 
current search rules. 



8. Note: The following exercise will work properly only if you have 
not executed the hmu command during this login session. If you 
have executed the hmu command, type the command: "tmr hmu". 

Attempt to list the number of users currently logged in (hmu). 

Suffice it to say: Do not indiscriminately add unfamiliar 
directories to your search rules. 

9. Log out. When you next log in, you will again be given the 
normal default search rules. 
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1. Log in and type the mail command. Recall that the mail command 
will extract messages and mail . Use this command if and when you 
receive notification that you have mail. 

2. If you have not received a message requesting partnership, choose 
an F01 user who is currently logged in and send him/her a message 
similar to the following: 

sra Student_07 .F01 May I be your partner? 

3. Send your partner messages in the dialogue mode, as in the 
following example. Wait for a reply between lines. 

sm Student_07.F01 

How are you doing today? 

That*s good. I'm not doing too bad myself. 

See you later. 



'. ' Mail your partner the contents of your add.pH segment. For 
example: 

mail add.pll Student_07 .F01 

5. List the ACL of your add.pll segment (la add.pll). Note: This 
ACL was given automatically by the system when you created 
add .pl1 . 

6. When your partner requests access to your add.pH segment (and he 
will), do the following: give your partner read access, verify 
by listing the ACL of your add.pll segment, and send a reply to 
your partner. For example: 

sa add.pll r Student_07 .* .* 

la add.pll 

sm Student_07 .F01 You now have access to add.pll* 

7. Attempt to print your partner's add.pH segment. For example: 

pr >udd>F01>Student_07>add.pl1 

Request read access to your partner's add.pH segment and attempt 
to print the segment again. (Keep trying until it works) 
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9. Note: Do not proceed until your partner has requested (and has 
been given) access to your add.pH segment. 

Remove your partner's name from your add.pll ACL. For example: 

da add=pl1 Student_07 . * .* 

Verify the change by again listing the ACL for add.pH 

10. List the ACL on your home directory (la). Who are these users? 
Attempt to set access for yourself on your home directory 
(sa -wd sma Student^?? .* .*) . Why can't you set access on your 
own home directory? 

11. Execute the following commands: 

Is -d 

la Programs 

copy alphabet Programs>A 

Is Programs>** 

Note your access on segment A. 

pr Programs>A 

da Programs Student_?? .F01 .* 

la Programs (What permissions are needed?) 

cr Progr£)ms>B (What permissions are needed?) 

Is Prograras>** (What permissions are needed?) 

dl Programs>A (What permissions are needed?) 

pr Programs>A (What permissions are needed?) 

Note that you can do nothing except print the contents of the 
segment A. 

12. Type the following command sequence. (If necessary, include your 
time zone in the -time request. For example: -time "4pm est") 

memo 

memo Happiness is Multing the day away. 

memo -time 4pm -alarm It's almost time to go home. 

memo -list 

memo 

13. Modify your start__up.ec to include the mail and memo commands. 
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14. Type the following command sequence. 

pat (print_attach_table) 

fo (file_output output_file) 

pat 

ro (revert_output) 

pr output_file 

Notice the difference in the I/O switch attachments. 

15. Before logging out, check your mailbox. 
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1. Send yourself the following messages: 
sm ME My working dir is [wd]. 
sm ME Last message sender was [1ms] 
sm MK The time is [time]. 

sm ME The date is [date] which is the same as [long_date]. 
sm ME [user name]. [user project] login at [user login_time] 
sm ME Current user load is [system n_users] . 
sm ME Multics: [system installation_id] . 
sm ME Multics: [system company], 
sm ME The absolute pathname is [path add], 
sm ME My one-component segments are [segs »]. 

2. Create the following abbreviation: 

.ab reply sm [ last_message__sender] 
List all of your abbreviations. 

3. Execute the following command lines: 

.s reply Who are you? 
reply Who are you? 

Who in fact was the last_message sender? 
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4. Create two segments 
following lines: 



"Names__A" and "Names_B" containing the 



Names A 




Names B 




Now execute the following command lines and observe the results: 
sm ME [contents Names_A] 

create [contents Names_A] [contents Names_B] 
list A» B» 

list [contents Names_A] 
dl [contents Names_A] 
list A* B» 

). Create an exec_com segment containing the following text: 

query. ec 



&command_line off 

cwd [response "Working directory desired?"] 

&print Your working directory is: 

pwd 

sm ME [response "What would you like to say to yourself?"] 



The fir-st line of the above exec_com wil] inhibit the printing 
(echoing) of the command lines when the exec com is executed. 

Now invoke this exec_com and provide legitimate answers to the 
questions asked. Invoke the exec com again, but this time respond 
to the first question by simply hitting the line feed key. Do you 
understand why you are now back at your home directory? 
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6. Use qedx to create the following exec_com: 

recur .ec 



&command_line off 

&print ENTRY: &n arguments, first argument is &1 

&if [ngreater &n 0] &then &goto START 

&quit 

&label START 

&print Executing exec_com command 

ec recur. ec &2 &3 &4 &5 &6 &7 &8 

&print EXIT: &n arguments, first argument is &1 

&quit 



Invoke the exec_cora and observe the results by typing: 
ec recur. ec ABCDEFGH 

Change your working directory to your Programs directory and 
again invoke this exec_com by typing: 

ec >udd>F01>Student_??>recur.ec ABC 

Why does the exec_com fail now? Can you correct the problem? 
Try to correct the problem. 

7. Return to your home directory and execute the following sequence 
of commands 

.ab pl1_ex do "pr &1.pl1;pl1 &1.pll; [entry &1]; logout" 

.a F1 >udd>F01 

.1 

pl1_ex F1>Student_01>nothing 

The entry active function returns the entryname of the supplied 
pathname. Why was the entry active function used? Was it 
necessary? Why were you logged out? 
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Use command line iteration to send yourself several messages. 
For example, if you are Student_06 type the following line: 

sm Student_0(6 6 6 6).F01 This is number (1 2 3 4)! 

Recall the contents of your segments Names_A and Names_B and 
execute the following command lines: 

sm ME [contents Names_B] 

sm ME ([contents Names_B]) 

list [contents Names_B] 

rename ([contents Names_B]) ([contents Names_A]) 

list A* B* 

create ([contents Names_A]) . [date] . [user name] 

list A».** 

rename A*.** =.= 

list A».»* 
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The print command only allows one pathname argument such as 
"print add.pH". Use command line iteration to print the 
segments Prince and alphabet as follows: 

print (Prince alphabet) 

Now execute the following command lines to create and test an 
abbreviation for the print command that allows it to accept up to 
five pathnames as arguments. 

.ab :pr do "print (&1 &2 &3 &4 &5)" 

:pr Prince alphabet >udd>F01 >Student_01 >nothing.pl1 

What would happen if the abbrev had been defined as follows: 

.ab print do "print (&1 &2 &3 &4 &5)" 

Try it! When you get the error message, notice the level clause 
of your ready message. Go into probe and execute the "stack" 
request. Do you understand why the stack overflowed? (You will 
probably want to "break" inorder to stop the output from the 
stack request.) Recursion is one reason why command names are 
normally not used for abbreviations. 

Now generalize the print command abbreviation to accept star 
names and test it by typing the following command lines: 

.ab :pr do "print ([segs &1])" 
:pr s*.* 
:pr alphabet 

Modify your start_up.ec to include the three new lines as 
indicated below: 

start up.ec 



&command line off 



{previous contents} 



&print Start_up complete 
&quit 
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Execute your start_up.ec to verify its proper functioning. 
Execute the new_proc command and observe the results (this may 
take a minute or so) . 



Create the following exec_com and name it weird. ec. 

weird. ec 



&print Beginni 
&if [nequal &n 


fig 
2] 


&ec name 
&then &g 


exec 
oto 


com 
LOGOUT 


pwd 
Is 

ind &1 
pl1 &1 
pr &1 .1 
&quit 


.pll 
.pll 

3l1 












&label 
&print 
logout 
&quit 


LOGOUT 
Bye Bye 













Execute your weird exec_com using the following command lines 
(you will receive some error messages since sub. pll does not 
exist) : 

ec weird. ec add 
ec weird. ec sub 

Add the name weird. absin to your weird. ec segment (an weird. ec 
weird. absin) . Verify by executing the following list commands: 

Is weird.ec 
Is weird. absin 
Is weird.** 
Is w*.** 
Is **.ec 
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8. Submit an absentee request using your weird. absin segment as the 
absin segment. (ear weird. absin -ag add). Attempt to observe 
the absentee process by repeatedly typing: 

who Student_?? 

Hopefully you will notice yourself listed twice, for example: 

Student_08.F01 
Student__08.F01» 

9. After the absentee job has completed, you will find a 
weird. absout segment in the same directory as the weird. absin 
segment. Print and observe its contents. In particular, note 
the login and logout times, and the fact that the absentee 
process used your start_up.ec (which is potentially undesirable). 



stai t up . ec to recognize and 



nouiiy yuur _ 

login. Add the &if control line as indicated. 

start up.ec 



r espond to ciu cibsentee 



&command_line off 

abbrev 

&if [equal &2 absentee] &then &quit 



11. Submit again an absentee request for weird. absin. This time, 
however, schedule the absentee job for 8 am local time tomorrow 
morning (use your time zone if necessary) . For example: 

ear weird. absin -time "Friday 8am est" -ag add 

12. Execute your weird exec_com using two arguments. For example: 

ec weird. ec add mad 
Why were you logged out? 
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Log in to the system and see if your absentee request from 
yesterday ran as expected. 

Log out using the -hold control argument (logout -hold). Log 
back in. 



Type the following sequence of Ghange_wdir commands. Verify your 
working directory after each line via the print_wdir command. 

cwd < 

cwd < 

cwd 

cwd << 

cwd 

cwd <Student_01 

cwd 



Type the following sequence of commands. (You will receive some 
error messages.) 

cr A.ec B.ec C.ec (create) 

Is »».ec (list) 

an **,ec ==.absin (add_name) 

Is »*.ec (list) 

rn (A B C).ec (a b c).ec (rename) 

Is »».ec (list) 

cr "X Y" "A""B" (create) 

Is » (list) 

rn a.ec ;hmu (rename) 

rn a.ec ";hmu" (rename) 

Is « (list) 



Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 

wh pwd (where) 

pwd (print wdir) 

wh funny (whereT 

funny (funny) 

in >udd>F01>Student_01>funny (initiate) 

wh funny (where) 

funny (funny) 
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6. Type the following sequence of commands: (Note: You will 
receive some "Segment not found" error messages) 



Is -Ik 


(list) 


Is sad 


(list) 


sad 


(sad) 


Ik >udd>F01>Student_01>sad 


(link) 


•» _ 1 1 - 


/ 1 •! r.4- ^ 


IS -J.K 


V a.x O b> / 


Is sad 


(list) 


wh sad 


(where) 


sad 


(sad) 



7. Type the following sequence of commands: 

copy Prince PI (copy) 

list P* (list) 

cpa Prince P1 (compare_ascii) 

ac rd A. archive Prince P1 (archive) 

ac t A. archive (archive) 

list P» (list) 

ac X A. archive (archive) 

list P* (list) 

ss P1 (sort_seg) 

pr P1 (print) 

cpa Prince PI (compare_ascii) 

8. Type the following sequence of commands: 

wh list (where) 

Is [wh list] (list) 

Note the permissions you have on the list command procedure (this 
is the object program). Note also (from the add names) that the 
list command procedure is "bound" (see the bind command) with 
other operating system command procedures. 

9. Type the following sequence of commands. (You will not receive 
any terminal output for the first four commands.) 

fo t_file (file_output) 

pwd (print_wdir) 

Is -all (list) 

who .F01 (who) 

ro (revert_output) 

pwd (print wdir) 

pr t file (printT 



W-30 F01 



WORKSHOP NINE 



0. Type the following sequence of commands: 

pr Prince 

11 35 

or Prince 

11 80 



(print) 
(line_length) 
(print) 
(line length) 



1. Type the following sequence of commands: 

gr -string "Done Master!" -set 

pwd 

time 

ru 

gr -revert 

date 



(general_ready) 

(print_wdir) 

(time) 

(resource_usage) 

(general_ready) 

(date) 



Turn off the ready message (ready_off). Most experienced users 

prefer this mode because they can interact faster. Type the 

following sequence of commands just to get the feel of having no 
ready message: ' 



gq 


(get_quota) 


gq < 


(get__quota) 


cwd 


(change__wdir) 


11 79 


(line_length) 


an PI P2 


(add_name) 


>udd>F01 >Student_01 >reassure 


(reassure) 


ready 


(ready) 


dn P2 


(delete name) 


cr seg_3 


(createT 


• 


(period) 


ready__on 


(ready on) 


Is seg_3 


(list) 


logout 


(logout) 



{. .} 

V 




Happiness is Mult'ing the day away! 
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